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xv6 is a re-implementation of Dennis Ritchie's and Ken Thompson's Unix 
Version 6 (v6) . xv6 loosely follows the structure and style of v6, 
but is implemented for a modern x86-based multiprocessor using ANSI C. 

ACKNOWLEDGMENTS 

xv6 is inspired by John Lions' s Commentary on UNIX 6th Edition (Peer 
to Peer Communications; ISBN: 1-57398-013-7; 1st edition (June 14, 
2000)). See also http://pdos.csail.mit.edU/6.828/2012/v6.html, which 
provides pointers to on-line resources for v6. 

xv6 borrows code from the following sources: 

JOS (asm.h, elf.h, mmu.h, bootasm.S, ide.c, console. c, and others) 
Plan 9 (entryother.S, mp.h, mp.c, lapic.c) 
FreeBSD (ioapic.c) 
NetBSD (console. c) 

The following people have made contributions: 
Russ Cox (context switching, locking) 
Cliff Frey (MP) 
Xiao Yu (MP) 
Nickolai Zeldovich 
Austin Clements 

In addition, we are grateful for the bug reports and patches contributed by 
Silas Boyd-Wickizer, Peter Froehlich, Shivam Handa, Anders Kaseorg, Eddie 
Kohler, Yandong Mao, Hitoshi Mitake, Carmi Merimovich, Joel Nider, Greg Price, 
Eldar Sehayek, Yongming Shen, Stephen Tu, and Zouchangwei. 

The code in the files that constitute xv6 is 

Copyright 2006-2014 Frans Kaashoek, Robert Morris, and Russ Cox. 
ERROR REPORTS 

If you spot errors or have suggestions for improvement, please send 
email to Frans Kaashoek and Robert Morris (kaashoek, rtm@csail.mit .edu) . 

BUILDING AND RUNNING XV6 

To build xv6 on an x86 ELF machine (like Linux or FreeBSD), run "make". 
On non-x86 or non-ELF machines (like OS X, even on x86), you will 
need to install a cross-compiler gcc suite capable of producing x86 ELF 
binaries. See http://pdos.csail.mit.edU/6.828/2014/tools.html. 
Then run "make TOOLPREFIX=i386- jos-elf-" . 

To run xv6, install the QEMU PC simulators. To run in QEMU, run "make qemu". 

To create a typeset version of the code, run "make xv6.pdf". This 
requires the "mpage" utility. See http://www.mesa.nl/pub/mpage/. 
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The numbers to the left of the file names in the table are sheet numbers. 

The source code has been printed in a double column format with fifty 

lines per column, giving one hundred lines per sheet (or page) . 

Thus there is a convenient relationship between line numbers and sheet numbers. 



# basic headers 


# system calls 


# string operations 


01 types. h 


31 traps. h 


65 string. c 


01 param.h 


32 vectors.pl 




02 memlayout.h 


32 trapasm.S 


# low-level hardware 


02 defs.h 


33 trap.c 


67 mp . h 


04 x86.h 


34 syscall.h 


69 mp . c 


06 asm.h 


35 syscall.c 


71 lapic.c 


07 mmu.h 


36 sysproc.c 


73 ioapic.c 


09 elf.h 




74 picirq.c 




# file system 


75 kbd.h 


# entering xv6 


37 buf.h 


76 kbd.c 


10 entry. S 


38 fcntl.h 


77 console. c 


11 entryother.S 


38 stat.h 


80 timer. c 


12 main.c 


39 fs.h 


81 uart.c 




40 file.h 




# locks 


41 ide.c 


# user-level 


15 spinlock.h 


43 bio.c 


82 initcode.S 


15 spinlock.c 


45 log.c 


82 usys.S 




47 fs.c 


83 init.c 


# processes 


56 file.c 


83 sh.c 


17 vm. c 


58 sysfile.c 




23 proc.h 


63 exec.c 


# bootloader 


24 proc.c 




89 bootasm.S 


2 9 swtch.S 


# pipes 


90 bootmain.c 


30 kalloc.c 


64 pipe.c 





The source listing is preceded by a cross-reference that lists every defined 
constant, struct, global variable, and function in xv6. Each entry gives, 
on the same line as the name, the line number (or, in a few cases, numbers) 
where the name is defined. Successive lines in an entry list the line 
numbers where the name is used. For example, this entry: 

swtch 2658 

0374 2428 2466 2657 2658 

indicates that swtch is defined on line 2658 and is mentioned on five lines 
on sheets 03, 24, and 26. 
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acquire 1574 

0377 1574 1578 2460 2587 2625 
2658 2717 2774 2818 2833 2866 
2879 3076 3093 3366 3722 3742 
4207 4265 4370 4430 4630 4657 
4674 5008 5041 5061 5090 5110 
5120 5629 5654 5668 6513 6534 
6555 7760 7916 7958 8006 

allocproc 2455 

2455 2507 2560 

allocuvm 1953 

0422 1953 1967 2537 6346 6358 

alltraps 3254 

3209 3217 3230 3235 3253 3254 

ALT 7510 

7510 7538 7540 

argfd 5819 

5819 5856 5871 5883 5894 5906 

argint 3545 

0395 3545 3558 3574 3682 3706 
3720 5824 5871 5883 6108 6176 
6177 6231 

argptr 3554 

0396 3554 5871 5883 5906 6257 
argstr 3571 

0397 3571 5918 6008 6108 6157 
6175 6207 6231 

BACK 8361 

8361 8474 8620 8889 
backcmd 8396 8614 

8396 8409 8475 8614 8616 8742 

8855 8890 
BACKSPACE 7850 

7850 7867 7894 7926 7932 
balloc 4804 

4804 4826 5167 5175 5179 
BBLOCK 3945 

3945 4813 4838 
begin_op 4628 

0333 2620 4628 5683 5774 5921 

6011 6111 6156 6174 6206 6320 
bfree 4831 

4831 5214 5224 5227 
bget 4366 

4366 4398 4406 
binit 4338 

0261 1231 4338 
bmap 5160 

5160 5186 5269 5319 
bootmain 9017 



8968 9017 



BPB 3942 



3942 


3945 


4812 


4814 


4839 




bread 4402 










0262 


4402 


4577 


4578 


4590 


4606 


4688 


4689 


4781 


4792 


4813 


4838 


4963 


4984 


5068 


5176 


5220 


5269 


5319 












brelse 4425 










0263 


4425 


4428 


4581 


4582 


4597 


4614 


4692 


4693 


4783 


4795 


4819 


4824 


4845 


4969 


4972 


4993 


5076 


5182 


5226 


5272 


5323 






BSIZE 3911 










3911 


3922 


3936 


3942 


4558 


4579 


4690 


4793 


5269 


5270 


5271 


5315 


5319 


5320 


5321 








buf 3750 












0250 


0262 


0263 


0264 


0306 


0332 


2120 


2123 


2132 


2134 


3750 


3754 


3755 


3756 


4111 


4126 


4129 


4175 


4204 


4254 


4256 


4259 


4326 


4330 


4334 


4340 


4353 


4365 


4368 


4401 


4404 


4414 


4425 


4505 


4577 


4578 


4590 


4591 


4597 


4606 


4607 


4613 


4614 


4688 


4689 


4722 


4768 


4779 


4790 


4807 


4833 


4956 


4981 


5055 


5163 


5209 


5255 


5305 


7729 


7740 


7744 


7747 


7903 


7924 


7938 


7968 


8001 


8008 


8484 


8487 


8488 


8489 


8503 


8515 


8516 


8519 


8520 


8521 


8525 












bwrite 4414 










0264 


4414 


4417 


4580 


4613 


4691 


bzero 47S 


38 










4788 


4820 










B_BUSY 3759 










3759 


4258 


4376 


4377 


4390 


4393 


4416 


4427 


4439 








B_DIRTY 3761 










3761 


4187 


4216 


4221 


4260 


4278 


4390 


4418 


4738 








B_VALID 3760 










3760 


4220 


4260 


4278 


4407 




C 7531 7909 










7531 


7579 


7604 


7605 


7606 


7607 


7608 


7610 


7909 


7919 


7922 


7929 


7940 


7969 










CAPSLOCK 


7512 










7512 


7545 


7686 
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cgaputc 7855 
7855 7898 



clearpteu 2029 





0431 


2029 


2035 


6360 






cli 


0557 














0557 


0559 


1126 


1660 


7810 


7889 




8912 












cmd 


8365 














8365 


8377 


8386 


8387 


8392 


8393 




8398 


8402 


8406 


8415 


8418 


8423 




8431 


8437 


8441 


8451 


8475 


8477 




8552 


8555 


8557 


8558 


8559 


8560 




8563 


8564 


8566 


8568 


8569 


8570 




8571 


8572 


8573 


8574 


8575 


8576 




8579 


8580 


8582 


8584 


8585 


8586 




8587 


8588 


8589 


8600 


8601 


8603 




8605 


8606 


8607 


8608 


8609 


8610 




8613 


8614 


8616 


8618 


8619 


8620 




8621 


8622 


8712 


8713 


8714 


8715 




8717 


8721 


8724 


8730 


8731 


8734 




8737 


8739 


8742 


8746 


8748 


8750 




8753 


8755 


8758 


8760 


8763 


8764 




8775 


8778 


8781 


8785 


8800 


8803 




8808 


8812 


8813 


8816 


8821 


8822 




8828 


8837 


8838 


8844 


8845 


8851 




8852 
8878 


8861 
8884 


8864 
8890 


8866 
8891 


8872 
8894 


8873 


COMl 8113 












8113 


8123 


8126 


8127 


8128 


8129 




8130 


8131 


8134 


8140 


8141 


8157 




8159 


8167 


8169 









commit 4701 



4553 4673 4701 
CONSOLE 4037 

4037 8021 8022 
consoleinit 8016 

0267 1227 8016 
consoleintr 7912 

0269 7698 7912 8175 
consoleread 7951 

7951 8022 
consolewrite 8001 

8001 8021 
consputc 7886 

7716 7747 7768 7786 7789 7793 

7794 7886 7926 7932 7939 8008 
context 2343 

0251 0374 2306 2343 2361 2488 

2489 2490 2491 2728 2766 2928 
copy out 2118 



0430 2118 6368 6379 
copyuvm 2053 

0427 2053 2064 2066 2564 
cprintf 7752 

0268 1224 1264 1967 2926 2930 

2932 3390 3403 3408 3633 7019 

7039 7211 7362 7752 7812 7813 

7814 7817 
cpu 2304 

0309 1224 1264 1266 1278 1506 

1566 1587 1608 1646 1661 1662 

1670 1672 1718 1731 1737 1876 

1877 1878 1879 2304 2314 2318 

2329 2728 2759 2765 2766 2767 

3365 3390 3391 3403 3404 3408 

3410 6913 6914 7211 7812 
cpunum 7201 

0323 1288 1724 7201 7373 7382 
CR0_PE 0727 

0727 1135 1171 8943 
CR0_PG 0737 

0737 1050 1171 
CR0_WP 0733 

0733 1050 1171 
CR4_PSE 0739 

0739 1043 1164 
create 6057 

6057 6077 6090 6094 6114 6157 

6178 
CRTPORT 7851 

7851 7860 7861 7862 7863 7878 

7879 7880 7881 
CTL 7509 

7509 7535 7539 7685 
deallocuvm 1982 

0423 1968 1982 2016 2540 
DEVSPACE 0204 

0204 1832 1845 
devsw 4030 

4030 4035 5258 5260 5308 5310 

5611 8021 8022 
dinode 3926 

3926 3936 4957 4964 4982 4985 

5056 5069 
dirent 3950 

3950 5364 5405 5966 6004 
dirlink 5402 

0286 5371 5402 5417 5425 5941 

6089 6093 6094 
dirlookup 5361 
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0287 5361 5367 5409 5525 6023 

6067 
DIRSIZ 3948 

3948 3952 5355 5422 5478 5479 

5542 5915 6005 6061 
DPL_USER 0779 

0779 1727 1728 2514 2515 3323 

3418 3427 
EOESC 7516 

7516 7670 7674 7675 7677 7680 
elfhdr 0955 

0955 6315 9019 9024 
ELF_MAGIC 0952 

0952 6331 9030 
ELF_PROG_LOAD 0986 

0986 6342 
encl_op 4 653 

0334 2622 4653 5685 5779 5923 

5930 5948 5957 6013 6047 6052 

6116 6121 6127 6136 6140 6158 

6162 6179 6183 6208 6214 6219 

6322 6352 6405 
entry 1040 

0961 1036 1039 1040 3202 3203 

6392 6771 9021 9045 9046 
EOI 7114 

7114 7184 7225 
ERROR 7135 

7135 7177 
ESR 7117 

7117 7180 7181 
EXEC 8357 

8357 8422 8559 8865 
exec 6310 

0273 6247 6310 8268 8329 8330 

8426 8427 
execcmd 8369 8553 

8369 8410 8423 8553 8555 8821 

8827 8828 8856 8866 
exit 2604 

0359 2604 2642 3355 3359 3419 

3428 3667 8216 8219 8261 8326 

8331 8416 8425 8435 8480 8528 

8535 
EXTMEM 0202 

0202 0208 1829 
fdalloc 5838 

5838 5858 6132 6262 
fetchint 3517 

0398 3517 3547 6238 



fetchstr 3529 



0399 


3529 


3576 


6244 






4000 










0252 


0276 


0277 


0278 


0280 


0281 


0282 


0351 


2364 


4000 


4770 


5608 


5614 


5624 


5627 


5630 


5651 


5652 


5664 


5666 


5702 


5715 


5752 


5813 


5819 


5822 


5838 


5853 


5867 


5879 


5892 


5903 


6105 


6254 


6456 


6471 


7710 


8108 


8378 


8433 


8434 


8564 


8572 


8772 











filealloc 5625 

0276 5625 6132 6477 
fileclose 5664 

0277 2615 5664 5670 5897 6134 
6265 6266 6504 6506 

filedup 5652 

0278 2579 5652 5656 5860 
fileinit 5618 

0279 1232 5618 
fileread 5715 

0280 5715 5730 5873 
filestat 5702 

0281 5702 5908 
filewrite 5752 

0282 5752 5784 5789 5885 
FL_IF 0710 

0710 1662 1668 2518 2763 7208 
fork 2554 

0360 2554 3661 8260 8323 8325 

8543 8545 
forkl 8539 

8400 8442 8454 8461 8476 8524 

8539 
forkret 2783 

2417 2491 2783 
freerange 3051 

3011 3034 3040 3051 
freevm 2010 

0424 2010 2015 2078 2671 6395 

6402 
gatedesc 0901 

0523 0526 0901 3311 
getcallerpcs 1626 

0378 1588 1626 2928 7815 
getcmd 8484 

8484 8515 
gettoken 8656 

8656 8741 8745 8757 8770 8771 

8807 8811 8833 
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growproc 2531 

0361 2531 3709 
havediskl 4128 

4128 4164 4262 
holding 1644 

0379 1577 1604 1644 2757 
ialloc 4953 

0288 4953 4974 6076 6077 
IBLOCK 3939 

3939 4963 4984 5068 
ICRHl 7128 

7128 7187 7256 7268 
ICRLO 7118 

7118 7188 7189 7257 7259 7269 
ID 7111 

7111 7147 7216 
ideinit 4151 

0304 1234 4151 
ideintr 4202 

0305 3374 4202 
idelock 4125 

4125 4155 4207 4209 4228 4265 
4279 4282 
iderw 4254 

0306 4254 4259 4261 4263 4408 
4419 

idestart 4175 

4129 4175 4178 4226 4275 
idewalt 4133 

4133 4158 4180 4216 
IDE_BSY 4113 

4113 4137 
IDE_CMD_READ 4118 

4118 4191 
IDE_CMD_WRITE 4119 

4119 4188 
IDE_DF 4115 

4115 4139 
IDE_DRDY 4114 

4114 4137 
IDE_ERR 4116 

4116 4139 
idtinit 3329 

0406 1265 3329 
idup 5039 

0289 2580 5039 5512 
iget 5004 

4923 4970 5004 5024 5379 5510 
iinit 4918 

0290 1233 4918 



ilock 5053 

0291 5053 5059 
5724 5775 5927 
6025 6065 6069 
6325 7963 7983 

inb 0453 

0453 4137 4163 

7861 7863 8134 

8167 8169 8923 

initlock 1562 

0380 1562 2425 

4342 4562 4920 
8019 

initlog 4556 

0331 2794 4556 

inituvm 1903 

0425 1903 1908 

inode 4012 

0253 0286 0287 

0292 0293 0294 
0299 0300 0301 
4006 4012 4031 
4923 4952 4979 
5038 5039 5053 
5160 5206 5237 
5361 5402 5406 
5550 5916 5963 
6106 6154 6169 
8001 

INPUT_BUF 7900 

7900 7903 7924 

7968 
insl 0462 

0462 0464 4217 

install_trans 4572 

4572 4621 4706 
INT_DISABLED 7319 

7319 7367 
lOAPlC 7308 

7308 7358 
ioapic 7327 

7007 7029 7030 

7337 7343 7344 
ioapicenable 7373 

0309 4157 7373 
ioapicid 6917 

0310 6917 7030 
ioapicinit 7351 

0311 1226 7351 
ioapicread 7334 



5079 


5515 


5705 


5940 


5953 


6017 


6079 


6124 


6211 


8010 






7054 


7664 


7667 


8140 


8141 


8157 


8931 


9054 




3032 


3325 


4155 


5620 


6485 


8018 


4559 






2511 






0288 


0289 


0291 


0295 


0297 


0298 


0426 


1918 


2365 


4032 


4773 


4914 


5003 


5006 


5012 


5085 


5108 


5130 


5252 


5302 


5360 


5504 


5507 


5539 


6003 


6056 


6060 


6204 


6316 


7951 


7936 


7938 


7940 


9073 






7324 


7327 


7336 


7358 






8026 


8143 




7047 


7361 


7362 


7362 
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7334 7359 7360 
ioapicwrite 7341 

7341 7367 7368 7381 7382 
I0_PIC1 7407 

7407 7420 7435 7444 7447 7452 
7462 7476 7477 

I0_PIC2 7408 

7408 7421 7436 7465 7466 7467 
7470 7479 7480 

IO_RTC 7235 

7235 7248 7249 
I0_TIMER1 8059 

8059 8068 8078 8079 
IPB 3936 

3936 3939 3945 4964 4985 5069 
iput 5108 

0292 2621 5108 5114 5133 5410 
5533 5684 5946 6218 

1RQ_C0M1 3183 

3183 3384 8142 8143 
1RQ_ERR0R 3185 

3185 7177 
IRQ_IDE 3184 

3184 3373 3377 4156 4157 
IRQ_KBD 3182 

3182 3380 8025 8026 
IRQ_SLAVE 7410 

7410 7414 7452 7467 
1RQ_SPURI0US 3186 

3186 3389 7157 
1RQ_T1MER 3181 

3181 3364 3423 7164 8080 
isdirempty 5963 

5963 5970 6029 
ismp 6915 

0337 1235 6915 7012 7020 7040 

7043 7355 7375 
itrunc 5206 

4773 5117 5206 
iunlock 5085 

0293 5085 5088 5132 5522 5707 
5727 5778 5936 6139 6217 7956 
8005 

iunlockput 5130 

0294 5130 5517 5526 5529 5929 
5942 5945 5956 6030 6041 6045 
6051 6068 6072 6096 6126 6135 
6161 6182 6213 6351 6404 

iupdate 4979 

0295 4979 5119 5232 5328 5935 



5955 6039 6044 6083 6087 
I_BUSY 4025 

4025 5062 5064 5087 5091 5113 
5115 

I_VALID 4026 

4026 5067 5077 5111 
kalloc 3088 

0314 1294 1763 1842 1909 1965 
2069 2473 3088 6479 

KBDATAP 7504 

7504 7667 
kbdgetc 7656 

7656 7698 
kbdintr 7696 

0320 3381 7696 
KBSTATP 7502 

7502 7664 
KBS_DIB 7503 

7503 7665 
KERNBASE 0207 

0207 0208 0212 0213 0217 0218 
0220 0221 1315 1633 1829 1958 
2016 

KERNLINK 0208 

0208 1830 
KEY_DEL 7528 

7528 7569 7591 7615 
KEY_DN 7522 

7522 7565 7587 7611 
KEY_END 7520 

7520 7568 7590 7614 
KEYJOME 7519 

7519 7568 7590 7614 
KEY_1NS 7527 

7527 7569 7591 7615 
KEY_LF 7523 

7523 7567 7589 7613 
KEY_PGDN 7526 

7526 7566 7588 7612 
KEY_PGUP 7525 

7525 7566 7588 7612 
KEY_RT 7524 

7524 7567 7589 7613 
KEY_UP 7521 

7521 7565 7587 7611 
kfree 3065 

0315 1998 2000 2020 2023 2565 
2669 3056 3065 3070 6502 6523 

kill 2875 

0362 2875 3409 3684 8267 
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kinitl 3030 

0316 1219 3030 
kinit2 3038 

0317 1238 3038 
KSTACKSIZE 0151 

0151 1054 1063 1295 1879 2477 
kvmalloc 1857 

0418 1220 1857 
lapiceoi 7222 

0325 3371 3375 3382 3386 3392 
7222 

lapicinit 7151 

0326 1222 1256 7151 
lapicstartap 7240 

0327 1299 7240 
lapicw 7144 

7144 7157 7163 7164 7165 7168 

7169 7174 7177 7180 7181 7184 

7187 7188 7193 7225 7256 7257 

7259 7268 7269 
lcr3 0590 

0590 1868 1883 
Igdt 0512 

0512 0520 1133 1733 8941 
lidt 0526 

0526 0534 3331 
LINTO 7133 

7133 7168 
LINTl 7134 

7134 7169 
LIST 8360 

8360 8440 8607 8883 

listcmd 8390 8601 

8390 8411 8441 8601 8603 8746 
8857 8884 

loadgs 0551 
0551 1734 

loaduvm 1918 

0426 1918 1924 1927 6348 

log 4537 4550 

4537 4550 4562 4564 4565 4566 
4576 4577 4578 4590 4593 4594 
4595 4606 4609 4610 4611 4622 
4630 4632 4633 4634 4636 4638 
4639 4657 4658 4659 4660 4661 
4663 4666 4668 4674 4675 4676 
4677 4687 4688 4689 4703 4707 
4726 4728 4731 4732 4735 4736 
4737 

logheader 4532 



4532 4544 4558 4559 4591 4607 
LOGSIZE 0160 

0160 4534 4634 4726 5767 
log_write 4722 

0332 4722 4729 4794 4818 4844 

4968 4992 5180 5322 
Itr 0538 

0538 0540 1880 
mappages 1779 

1779 1848 1911 1972 2072 
MAXARG 0158 

0158 6227 6314 6365 
MAXARGS 8363 

8363 8371 8372 8840 
MAXFILE 3923 

3923 5315 
MAXOPBLOCKS 0159 

0159 0160 0161 4634 
memcmp 6615 

0386 6615 6945 6988 
memmove 6631 

0387 1285 1912 2071 2132 4579 
4690 4782 4991 5075 5271 5321 
5479 5481 6631 6654 7873 

memset 6604 

0388 1766 1844 1910 1971 2490 
2513 3073 4793 4966 6034 6234 
6604 7875 8487 8558 8569 8585 
8606 8619 

microdelay 7231 

0328 7231 7258 7260 7270 8158 
min 4772 

4772 5270 5320 
mp 6752 

6752 6908 6937 6944 6945 6946 
6955 6960 6964 6965 6968 6969 
6980 6983 6985 6987 6994 7004 
7010 7050 
mpbcpu 6920 

0338 6920 
MPBUS 6802 

6802 7033 
mpconf 6763 

6763 6979 6982 6987 7005 
mpconfig 6980 

6980 7010 
mpenter 1252 

1252 1296 
mpinit 7001 

0339 1221 7001 7019 7039 
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MPIOAPIC 6803 

6803 7028 
mpioapic 6789 

6789 7007 7029 7031 
MPIOINTR 6804 

6804 7034 
MPLINTR 6805 

6805 7035 
mpmain 1262 

1209 1241 1257 1262 
MPPROC 6801 

6801 7016 
mpproc 6778 

6778 7006 7017 7026 
mpsearch 6956 

6956 6985 
mpsearchl 6938 

6938 6964 6968 6971 
multiboot_header 1025 

1024 1025 
namecmp 5353 

0296 5353 5374 6020 
namei 5540 

0297 2523 5540 5922 6120 6207 
6321 

nameiparent 5551 

0298 5505 5520 5532 5551 5938 
6012 6063 

namex 5505 

5505 5543 5553 
NBUF 0161 

0161 4330 4353 
NCPU 0152 

0152 2318 6913 
ncpu 6916 

1224 1287 2319 4157 6916 7018 

7019 7023 7024 7025 7045 
NDEV 0156 

0156 5258 5308 5611 
NDIRECT 3921 

3921 3923 3932 4023 5165 5170 

5174 5175 5212 5219 5220 5227 

5228 
NELEM 0434 

0434 1847 2922 3630 6236 
nextpid 2416 

2416 2469 
NFILE 0154 

0154 5614 5630 
NINDIRECT 3922 



3922 3923 5172 5222 
NINODE 0155 

0155 4914 5012 
NO 7506 

7506 7552 7555 7557 7558 7559 
7560 7562 7574 7577 7579 7580 
7581 7582 7584 7602 7603 7605 
7606 7607 7608 

NOFILE 0153 

0153 2364 2577 2613 5826 5842 

NPDENTRIES 0821 

0821 1311 2017 
NPROC 0150 

0150 2411 2461 2631 2662 2718 
2857 2880 2919 
NPTENTRIES 0822 

0822 1994 
NSEGS 2301 

1711 2301 2308 

nulterminate 8852 

8715 8730 8852 8873 8879 8880 
8885 8886 8891 

NUMLOCK 7513 
7513 7546 

outb 0471 

0471 4161 4170 4181 4182 4183 
4184 4185 4186 4188 4191 7053 
7054 7248 7249 7420 7421 7435 
7436 7444 7447 7452 7462 7465 
7466 7467 7470 7476 7477 7479 
7480 7860 7862 7878 7879 7880 
7881 8077 8078 8079 8123 8126 
8127 8128 8129 8130 8131 8159 
8928 8936 9064 9065 9066 9067 
9068 9069 

outsl 0483 

0483 0485 4189 

outw 0477 

0477 1181 1183 8974 8976 

0_CREATE 3803 

3803 6113 8778 8781 

0_RDONLY 3800 

3800 6125 8775 
0_RDWR 3802 

3802 6146 8314 8316 8507 
0_WRONLY 3801 

3801 6145 6146 8778 8781 
P2V 0218 

0218 1219 1238 6962 7250 7852 
panic 7805 8532 
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0270 


1578 


1605 


1669 


1671 


1790 


1846 


1882 


1908 


1924 


1927 


1998 


2015 


2035 


2064 


2066 


2510 


2610 


2642 


2758 


2760 


2762 


2764 


2806 


2809 


3070 


3405 


4178 


4259 


4261 


4263 


4398 


4417 


4428 


4559 


4660 


4727 


4729 


4826 


4842 


4974 


5024 


5059 


5079 


5088 


5114 


5186 


5367 


5371 


5417 


5425 


5656 


5670 


5730 


5784 


5789 


5970 


6028 


6036 


6077 


6090 


6094 


7763 


7805 


7812 


8401 


8420 


8453 


8532 


8545 


8728 


8772 


8806 


8810 


8836 


8841 






panicked 


7718 










7718 


7818 


7888 









parseblock 8801 

8801 8806 8825 
parsecmd 8718 

8402 8525 8718 
parseexec 8817 

8714 8755 8817 
parseline 8735 

8712 8724 8735 8746 8808 
parsepipe 8751 

8713 8739 8751 8758 
parseredirs 8764 

8764 8812 8831 8842 
POINT 7132 

7132 7174 
pde_t 0103 

0103 0420 0421 0422 0423 0424 

0425 0426 0427 0430 0431 1210 

1270 1311 1710 1754 1756 1779 

1836 1839 1842 1903 1918 1953 

1982 2010 2029 2052 2053 2055 

2102 2118 2355 6318 
PDX 0812 

0812 1759 
PDXSHIFT 0827 

0812 0818 0827 1315 
peek 8701 

8701 8725 8740 8744 8756 8769 

8805 8809 8824 8832 
PGROUNDDOWN 0830 

0830 1784 1785 2125 
PGROUNDUP 0829 

0829 1963 1990 3054 6357 
PGSIZE 0823 

0823 0829 0830 1310 1766 1794 

1795 1844 1907 1910 1911 1923 



1925 1929 1932 1964 1971 1972 
1991 1994 2062 2071 2072 2129 
2135 2512 2519 3055 3069 3073 
6358 6360 

PHYSTOP 0203 

0203 1238 1831 1845 1846 3069 

picenable 7425 

0343 4156 7425 8025 8080 8142 
picinit 7432 

0344 1225 7432 
picsetmask 7417 

7417 7427 7483 
pinit 2423 

0363 1229 2423 
PIPE 8359 

8359 8450 8586 8877 
pipe 6461 

0254 0352 0353 0354 4005 5681 

5722 5759 6461 6473 6479 6485 

6489 6493 6511 6530 6551 8263 

8452 8453 
pipealloc 6471 

0351 6259 6471 
pipeclose 6511 

0352 5681 6511 
pipecmd 8384 8580 

8384 8412 8451 8580 8582 8758 
8858 8878 
piperead 6551 

0353 5722 6551 
PIPESIZE 6459 

6459 6463 6536 6544 6566 
pipewrite 6530 

0354 5759 6530 
popcli 1666 

0383 1621 1666 1669 1671 1884 
printint 7726 

7726 7776 7780 
proc 2353 



0255 


0358 


0428 


1205 


1558 


1706 


1738 


1873 


1879 


2315 


2330 


2353 


2359 


2406 


2411 


2414 


2454 


2457 


2461 


2504 


2535 


2537 


2540 


2543 


2544 


2557 


2564 


2570 


2571 


2572 


2578 


2579 


2580 


2582 


2606 


2609 


2614 


2615 


2616 


2621 


2623 


2628 


2631 


2632 


2640 


2655 


2662 


2663 


2683 


2689 


2710 


2718 


2725 


2728 


2733 


2761 


2766 


2775 


2805 


2823 


2824 


2828 


2855 


2857 


2877 


2880 
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2915 


2919 


3305 


3354 


3356 


3358 


3401 


3409 


3410 


3412 


3418 


3423 


3427 


3505 


3519 


3533 


3536 


3547 


3560 


3629 


3631 


3634 


3635 


3656 


3690 


3708 


3725 


4107 


4766 


5512 


5811 


5826 


5843 


5844 


5896 


6218 


6220 


6264 


6304 


6386 


6389 


6390 


6391 


6392 


6393 


6394 


6454 


6537 


6557 


6911 


7006 


7017 


7018 


7019 


7022 


7713 


7961 


8110 






procdump 


2904 










0364 


2904 


7920 








proghdr ( 


3974 










0974 


6317 


9020 


9034 






PTE_ADDR 


0844 










0844 


1761 


1928 


1996 


2019 


2067 



2111 
PTE_FLAGS 0845 

0845 2068 
PTE_P 0833 

0833 1313 1315 1760 1770 1789 
1791 1995 2018 2065 2107 

PTE_PS 0840 

0840 1313 1315 
pte_t 0848 

0848 1753 1757 1761 1763 1782 

1921 1984 2031 2056 2104 
PTE_U 0835 

0835 1770 1911 1972 2036 2109 
PTE_W 0834 

0834 1313 1315 1770 1829 1831 
1832 1911 1972 

PTX 0815 

0815 1772 
PTXSHIFT 0826 

0815 0818 0826 
pushcli 1655 

0382 1576 1655 1875 
rcr2 0582 

0582 3404 3411 
readeflags 0544 

0544 1659 1668 2763 7208 
readi 5252 

0299 1933 5252 5370 5416 5725 

5969 5970 6329 6340 
readsb 4777 

0285 4563 4777 4811 4837 4960 
readsect 9060 

9060 9095 
readseg 9079 



9014 9027 9038 9079 
read_head 4588 

4588 4620 
recover_from_log 4618 

4552 4567 4618 
REDIR 8358 

8358 8430 8570 8871 
redircmd 8375 8564 

8375 8413 8431 8564 8566 8775 

8778 8781 8859 8872 
REG_ID 7310 

7310 7360 
REG_TABLE 7312 

7312 7367 7368 7381 7382 
REG_VER 7311 

7311 7359 
release 1602 



0381 


1602 


1605 


2464 


2470 


2589 


2677 


2684 


2735 


2777 


2787 


2819 


2832 


2868 


2886 


2890 


3081 


3098 


3369 


3726 


3731 


3744 


4209 


4228 


4282 


4378 


4394 


4442 


4639 


4668 


4677 


5015 


5031 


5043 


5065 


5093 


5116 


5125 


5633 


5637 


5658 


5672 


5678 


6522 


6525 


6538 


6547 


6558 


6569 


7801 


7948 


7962 


7982 


8009 



ROOTDEV 0157 

0157 4563 4566 5510 
ROOTINO 3910 

3910 5510 
run 3014 

2911 3014 3015 3021 3067 3077 

3090 
runcmd 8406 

8406 8420 8437 8443 8445 8459 

8466 8477 8525 
RUNNING 2350 

2350 2727 2761 2911 3423 
safestrcpY 6682 

0389 2522 2582 6386 6682 
sched 2753 

0366 2641 2753 2758 2760 2762 

2764 2776 2825 
scheduler 2708 

0365 1267 2306 2708 2728 2766 
SCROLLLOCK 7514 

7514 7547 
SECTSIZE 9012 

9012 9073 9086 9089 9094 
SEG 0769 
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0769 1725 1726 1727 1728 1731 
SEG16 0773 

0773 1876 
segdesc 0752 

0509 0512 0752 0769 0773 1711 

2308 
seginit 1716 

0417 1223 1255 1716 
SEG_ASM 0660 

0660 1190 1191 8984 8985 
SEG_KCODE 0741 

0741 1150 1725 3322 3323 8953 
SEG_KCPU 0743 

0743 1731 1734 3266 
SEG_KDATA 0742 

0742 1154 1726 1878 3263 8958 
SEG_NULLASM 0 654 

0654 1189 8983 
SEG_TSS 0746 

0746 1876 1877 1880 
SEG_UCODE 0744 

0744 1727 2514 
SEG_UDATA 0745 

0745 1728 2515 
SETGATE 0921 

0921 3322 3323 

setupkvin 1837 

0420 1837 1859 2060 2509 6334 

SHIFT 7508 

7508 7536 7537 7685 

skipelem 5465 
5465 5514 

sleep 2803 

0367 2689 2803 2806 2809 2909 
3729 4279 4381 4633 4636 5063 
6542 6561 7966 8279 

spinlock 1501 

0256 0367 0377 0379 0380 0381 
0409 1501 1559 1562 1574 1602 
1644 2407 2410 2803 3009 3019 
3308 3313 4110 4125 4325 4329 
4503 4538 4767 4913 5609 5613 
6457 6462 7708 7721 7902 8106 

start 1125 8208 8911 

1124 1125 1167 1175 1177 4539 
4564 4577 4590 4606 4688 8207 
8208 8910 8911 8967 

startothers 1274 
1208 1237 1274 

Stat 3854 



0257 0281 0300 3854 4764 5237 
5702 5809 5904 8303 

stati 5237 

0300 5237 5706 
STA_R 0669 0786 

0669 0786 1190 1725 1727 8984 
STA_W 0668 0785 

0668 0785 1191 1726 1728 1731 

8985 
STA_X 0665 0782 

0665 0782 1190 1725 1727 8984 
sti 0563 

0563 0565 1673 2714 
stosb 0492 

0492 0494 6610 9040 
stosl 0501 

0501 0503 6608 
strlen 6701 

0390 6367 6368 6701 8519 8723 
strncmp 6658 

0391 5355 6658 
strncpy 6668 

0392 5422 6668 
STS_IG32 0800 

0800 0927 
STS_T32A 0797 

0797 1876 
STS_TG32 0801 

0801 0927 
sum 692 6 

6926 6928 6930 6932 6933 6945 
6992 

superblock 3914 

0258 0285 3914 4561 4777 4808 
4834 4958 

SVR 7115 

7115 7157 
switchkvm 1866 

0429 1254 1860 1866 2729 
switchuvm 1873 

0428 1873 1882 2544 2726 6394 
swtch 2958 

0374 2728 2766 2957 2958 
SYSCALL 8253 8260 8261 8262 8263 82 

8260 8261 8262 8263 8264 8265 

8266 8267 8268 8269 8270 8271 

8272 8273 8274 8275 8276 8277 

8278 8279 8280 
syscall 3625 

0400 3357 3507 3625 
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SYS_chdir 3459 


sys_open 6101 


3459 3609 


3591 3615 6101 


SYS_chdir 6201 


SYS_pipe 3454 


3579 3609 6201 


3454 3604 


SYS_close 3471 


sys_pipe 6251 


3471 3621 


3592 3604 6251 


sys_close 5889 


SYS_read 3455 


3580 3621 5889 


3455 3605 


SYS_dup 3460 


sys_read 5865 


3460 3610 


3593 3605 5865 


sys_dup 5851 


SYS_sbrk 3462 


3581 3610 5851 


3462 3612 


SYS_exec 3457 


sys_sbrk 3701 


3457 3607 8212 


3594 3612 3701 


sys_exec 6225 


SYS_sleep 34 63 


3582 3607 6225 


3463 3613 


SYS_exit 3452 


sys_sleep 3715 


3452 3602 8217 


3595 3613 3715 


sys_exit 3665 


SYS_unlink 3468 


3583 3602 3665 


3468 3618 


SYS_fork 3451 


sys_unlink 6001 


3451 3601 


3596 3618 6001 


sys_fork 3659 


SYS_uptime 3464 


3584 3601 3659 


3464 3614 


SYS_fstat 3458 


sys_uptime 3738 


3458 3608 


3599 3614 3738 


sys_fstat 5901 


SYS_wait 3453 


3585 3608 5901 


3453 3603 


SYS_getpid 3461 


sys_wait 3672 


3461 3611 


3597 3603 3672 


sys_getpid 3688 


SYS_write 3466 


3586 3611 3688 


3466 3616 


SYS_kill 3456 


sys_write 5877 


3456 3606 


3598 3616 5877 


sys_kill 3678 


taskstate 0851 


3587 3606 3678 


0851 2307 


SYS_link 3469 


TDCR 7139 


3469 3619 


7139 7163 


sys_link 5913 


ticks 3314 


3588 3619 5913 


0407 3314 3367 


SYS_mkdir 3470 


3729 3743 


3470 3620 


tickslock 3313 


sys mkdir 6151 


0409 3313 3325 


3589 3620 6151 


3726 3729 3731 


SYS_mknod 3467 


TICR 7137 


3467 3617 


7137 7165 


sys_mknod 6167 


TIMER 7129 


3590 3617 6167 


7129 7164 


SYS_open 3465 


timerinit 8074 


3465 3615 


0403 1236 8074 



3744 
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TIMER_16BIT 8071 

8071 8077 
TIMER_D1V 8066 

8066 8078 8079 
TIMER_FREQ 8065 

8065 8066 
TIMER_MODE 8068 

8068 8077 
TIMER_RATEGEN 8070 

8070 8077 
TIMER_SEL0 8069 

8069 8077 
TPR 7113 

7113 7193 
trap 3351 

3202 3204 3272 3351 3403 3405 

3408 
trapframe 0602 

0602 2360 2481 3351 
trapret 3277 

2418 2486 3276 3277 
tvinit 3317 

0408 1230 3317 
T_DEV 3852 

3852 5257 5307 6178 
T_DIR 3850 

3850 5366 5516 5928 6029 6037 
6085 6125 6157 6212 

T_FILE 3851 

3851 6070 6114 
T_IRQO 317 9 

3179 3364 3373 3377 3380 3384 

3388 3389 3423 7157 7164 7177 

7367 7381 7447 7466 
T_SYSCALL 317 6 

3176 3323 3353 8213 8218 8257 
uart 8115 

8115 8136 8155 8165 
uartgetc 8163 

8163 8175 
uartinit 8118 



0412 1228 8118 
uartintr 8173 

0413 3385 8173 
uartputc 8151 

0414 7895 7897 8147 8151 
userinit 2502 

0368 1239 2502 2510 
uva2ka 2102 

0421 2102 2126 
V2P 0217 

0217 1830 1831 
V2P_W0 0220 

0220 1036 1046 
VER 7112 

7112 7173 
wait 2653 

0369 2653 3674 8262 8333 8444 
8470 8471 8526 

waitdisk 9051 

9051 9063 9072 
wakeup 2864 

0370 2864 3368 4222 4440 4666 
4676 5092 5122 6516 6519 6541 
6546 6568 7942 

wakeupl 2853 

2420 2628 2635 2853 2867 
walkpgdir 1754 

1754 1787 1926 1992 2033 2063 

2106 
writei 5302 

0301 5302 5424 5776 6035 6036 
write_head 4 604 

4604 4623 4705 4708 
write_log 4683 

4683 4704 
xchg 0569 

0569 1266 1583 1619 
yield 2772 

0371 2772 3424 
_attribute_ 1310 

0270 0365 1209 1310 
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0100 typedef 

0101 typedef 

0102 typedef 

0103 typedef 
0104 

0105 
0106 
0107 
0108 
0109 
0110 
0111 
0112 
0113 
0114 
0115 
0116 
0117 
0118 
0119 
0120 
0121 
0122 
0123 
0124 
0125 
0126 
0127 
0128 
0129 
0130 
0131 
0132 
0133 
0134 
0135 
0136 
0137 
0138 
0139 
0140 
0141 
0142 
0143 
0144 
0145 
0146 
0147 
0148 
0149 



unsigned int uint; 
unsigned short ushort; 
unsigned char uchar; 
uint pde_t; 
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0150 


#define NPROC 


64 


// 


maximum number of processes 


0151 


tdefine KSTACKSIZE 


4096 


// 


size of per-process kernel stack 


0152 


♦define NCPU 


8 


// 


maximum number of CPUs 


0153 


tdefine NOFILE 


16 


// 


open files per process 


0154 


♦define NFILE 


100 


// 


open files per system 


0155 


♦define NINODE 


50 


// 


maximum number of active i-nodes 


0156 


♦define NDEV 


10 


// 


maximum major device number 


0157 


♦define ROOTDEV 


1 


// 


device number of file system root disk 


0158 


♦define MAXARG 


32 


// 


max exec arguments 


0159 


♦define MAXOPBLOCKS 


10 


// 


max # of blocks any FS op writes 



0160 ^define LOGSIZE (MAX0PBL0CKS*3) // max data sectors in on-disk 

0161 ^define NBUF (MAX0PBL0CKS*3) // size of disk block cache 
0162 

0163 
0164 
0165 
0166 
0167 
0168 
0169 
0170 
0171 
0172 
0173 
0174 
0175 
0176 
0177 
0178 
0179 
0180 
0181 
0182 
0183 
0184 
0185 
0186 
0187 
0188 
0189 
0190 
0191 
0192 
0193 
0194 
0195 
0196 
0197 
0198 
0199 
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0200 
0201 
0202 
0203 
0204 
0205 
0206 
0207 
0208 
0209 
0210 
0211 
0212 
0213 
0214 
0215 
0216 
0217 
0218 
0219 
0220 
0221 
0222 
0223 
0224 
0225 
0226 
0227 
0228 
0229 
0230 
0231 
0232 
0233 
0234 
0235 
0236 
0237 
0238 
0239 
0240 
0241 
0242 
0243 
0244 
0245 
0246 
0247 
0248 
0249 



// Memory layout 

tdefine EXTMEM 0x100000 
♦define PHYSTOP OxEOOOOOO 
tdefine DEVSPACE OxFEOOOOOO 



// Start of extended memory 

// Top physical memory 

// Other devices are at high addresse 



// Key addresses for address space layout (see kmap in vm.c for layout) 
tdefine KERNBASE 0x80000000 // First kernel virtual address 

tdefine KERNLINK (KERNBASE+EXTMEM) // Address where kernel is linked 



tifndef ^ASSEMBLER 

static inline uint v2p(void *a) { return ( (uint) 
static inline void *p2v(uint a) | return (void *) 

#endif 



(a)) 
((a) 



KERNBASE; 
KERNBASE) 



♦define V2P(a) 
tdefine P2V(a) 



: (uint) 
: (void 



KERNBASE) 
+ KERNBASE) 



tdefine V2P_W0(x) ( (x) -KERNBASE) 
tdefine P2V_W0(x) ( (x) + KERNBASE) 



// same as V2P, but without casts 
// same as V2P, but without casts 
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0250 


struct 


buf; 




0251 


struct 


context; 




0252 


struct 


file; 




0253 


struct 


inode; 




0254 


struct 


pipe; 




0255 


struct 


proc; 




0256 


struct 


spinlock; 




0257 


struct 


Stat; 




0258 


struct 


superblock; 


0259 








0260 


// bio, 


.c 




0261 


void 




binit (void) ; 


0262 


struct 


buf* 


bread(uint, uint) ; 


0263 


void 




brelse (struct buf*); 


0264 


void 




bwrite (struct buf*); 


0265 








0266 


// console. c 




0267 


void 




consoleinit (void) ; 


0268 


void 




cprintf (char*, . . . ) ; 


0269 


void 




consoleintr (int (*) (void) ) ; 


0270 


void 




panic (char*) attribute ( (noreturn) ) 


0271 








0272 


// exec.c 




0273 


int 




exec (char*, char**); 


0274 








0275 


// file.c 




0276 


struct 


file* 


f ilealloc (void) ; 


0277 


void 




fileclose ( struct file*); 


0278 


struct 


file* 


filedup (struct file*); 


0279 


void 




fileinit (void) ; 


0280 


int 




fileread (struct file*, char*, int n) ; 


0281 


int 




filestat (struct file*, struct stat*); 


0282 


int 




filewrite (struct file*, char*, int n) ; 


0283 








0284 


// fs.c 






0285 


void 




readsb(int dev, struct superblock *sb) 


0286 


int 




dirlink (struct inode*, char*, uint); 


0287 


struct 


inode* 


dirlookup (struct inode*, char*, uint*) 


0288 


struct 


inode* 


ialloc(uint, short); 


0289 


struct 


inode* 


idup (struct inode*); 


0290 


void 




iinit (void) ; 


0291 


void 




ilock (struct inode*); 


0292 


void 




iput (struct inode*); 


0293 


void 




iunlock (struct inode*); 


0294 


void 




iunlockput (struct inode*); 


0295 


void 




iupdate (struct inode*); 


0296 


int 




namecmp (const char*, const char*); 


0297 


struct 


inode* 


namei (char*) ; 


0298 


struct 


inode* 


nameiparent (char*, char*); 


0299 


int 




readi (struct inode*, char*, uint, uint 
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0300 


void 


stati (struct inode*, struct stat*); 


0350 


// pipe.c 


0301 


int 


writei (struct inode*, char*, uint, uinti 


); 0351 


int 


0302 






0352 


void 


0303 


// ide.c 




0353 


int 


0304 


void 


ideinit (void) ; 


0354 


int 


0305 


void 


ideintr (void) ; 


0355 




0306 


void 


iderw (struct buf*); 


0356 




0307 






0357 


// proc.c 


0308 


// ioapic.c 




0358 


struct proc* 


0309 


void 


ioapicenable (int irq, int cpu) ; 


0359 


void 


0310 


extern uchar 


ioapicid; 


0360 


int 


0311 


void 


ioapicinit (void) ; 


0361 


int 


0312 






0362 


int 


0313 


// kalloc.c 




0363 


void 


0314 


char* 


kalloc (void) ; 


0364 


void 


0315 


void 


kfree (char*) ; 


0365 


void 


0316 


void 


kinitl (void*, void*); 


0366 


void 


0317 


void 


kinit2 (void*, void*); 


0367 


void 


0318 






0368 


void 


0319 


// kbd.c 




0369 


int 


0320 


void 


kbdintr (void) ; 


0370 


void 


0321 






0371 


void 


0322 


// lapic.c 




0372 




0323 


int 


cpunum (void) ; 


0373 


// swtch.S 


0324 


extern volatile 


uint* lapic; 


0374 


void 


0325 


void 


lapiceoi (void) ; 


0375 




0326 


void 


lapicinit (void) ; 


0376 


// spinlock.c 


0327 


void 


lapicstartap (uchar, uint); 


0377 


void 


0328 


void 


microdelay (int) ; 


0378 


void 


0329 






0379 


int 


0330 


// log.c 




0380 


void 


0331 


void 


initlog (void) ; 


0381 


void 


0332 


void 


log_write (struct buf*); 


0382 


void 


0333 


void 


begin_op ( ) ; 


0383 


void 


0334 


void 


end_op ( ) ; 


0384 




0335 






0385 


// string. c 


0336 


// mp.c 




0386 


int 


0337 


extern int 


ismp; 


0387 


void* 


0338 


int 


mpbcpu (void) ; 


0388 


void* 


0339 


void 


mpinit (void) ; 


0389 


char* 


0340 


void 


mpstartthem (void) ; 


0390 


int 


0341 






0391 


int 


0342 


// picirq.c 




0392 


char* 


0343 


void 


picenable (int) ; 


0393 




0344 


void 


picinit (void) ; 


0394 


// syscall.c 


0345 






0395 


int 


0346 






0396 


int 


0347 






0397 


int 


0348 






0398 


int 


0349 






0399 


int 



pipealloc (struct file**, struct file**); 
pipeclose (struct pipe*, int); 
piperead( struct pipe*, char*, int); 
pipewrite (struct pipe*, char*, int); 



copyproc (struct proc*); 

exit (void) ; 

fork (void) ; 

growproc (int) ; 

kill (int) ; 

pinit (void) ; 

procdump (void) ; 

scheduler (void) attribute ( (noreturn) ) ; 

sched (void) ; 

sleep (void*, struct spinlock*) ; 
userinit (void) ; 
wait (void) ; 
wakeup (void*) ; 
yield (void) ; 



swtch (struct context**, struct context*); 



acquire (struct spinlock*); 
getcallerpcs (void*, uint*); 
holding (struct spinlock*); 
initlock (struct spinlock*, char*); 
release (struct spinlock*); 
pushcli (void) ; 
popcli (void) ; 



memcmp (const void*, const void*, uint); 
memmove (void*, const void*, uint); 
memset (void*, int, uint); 
safestrcpy (char*, const char*, int); 
strlen(const char*); 

strncmp (const char*, const char*, uint); 
strncpy (char*, const char*, int); 



argint(int, int*); 
argptr(int, char**, int); 
argstr(int, char**); 
fetchint (uint, int*); 
f etchstr (uint, char**); 
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0400 void syscall (void) ; 

0401 

0402 // timer. c 

0403 void tiraerinit (void) ; 
0404 

0405 // trap.c 

0406 void idtinit (void) ; 

0407 extern uint ticks; 

0408 void tvinit (void) ; 

0409 extern struct spinlock tickslock; 

0410 

0411 // uart.c 

0412 void uartinit (void) ; 

0413 void uartintr (void) ; 

0414 void uartputc (int) ; 
0415 

0416 // vm.c 

0417 void seginit (void) ; 

0418 void kvmalloc (void) ; 

0419 void vmenable (void) ; 

0420 pde_t* setupkvm (void) ; 

0421 char* uva2ka (pde_t*, char*); 

0422 int allocuvm(pde_t*, uint, uint); 

0423 int deallocuvm(pde_t*, uint, uint); 

0424 void f reevm (pde_t*) ; 

0425 void inituvm(pde_t*, char*, uint); 

0426 int loaduvm(pde_t*, char*, struct inode*, uint, uint); 

0427 pde_t* copyuvm(pde_t*, uint); 

0428 void switchuvm (struct proc*) ; 

0429 void switchkvm (void) ; 

0430 int copyout (pde_t*, uint, void*, uint); 

0431 void clearpteu (pde_t *pgdir, char *uva) ; 

0432 

0433 // number of elements in fixed-size array 

0434 #define NELEM(x) (sizeof (x) /sizeof ( (x) [0] ) ) 
0435 

0436 
0437 
0438 
0439 
0440 
0441 
0442 
0443 
0444 
0445 
0446 
0447 



0449 
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0450 // Routines to let C code use special xB6 instructions. 

0451 

0452 static inline uchar 

0453 inb(ushort port) 

0454 { 

0455 uchar data; 
0456 

0457 asm volatileC'in %1,%0" : "=a" (data) : "d" (port)); 

0458 return data; 

0459 ) 

0460 

0461 static inline void 

0462 insl(int port, void *addr, int cnt) 

0463 { 

0464 asm volatile ("eld; rep insl" : 

0465 "=D" (addr), "=c" (cnt) : 

0466 "d" (port), "0" (addr), "1" (cnt) : 

0467 "memory", "cc"); 

0468 ) 
0469 

0470 static inline void 

0471 outb(ushort port, uchar data) 

0472 { 

0473 asm volatile ("out %0,%1" : : "a" (data), "d" (port)); 

0474 } 
0475 

0476 static inline void 

0477 outw(ushort port, ushort data) 

0478 ( 

0479 asm volatile ("out %0,%1" : : "a" (data), "d" (port)); 

0480 } 
0481 

0482 static inline void 

0483 outsl(int port, const void *addr, int cnt) 

0484 { 

0485 asm volatile ("eld; rep outsl" : 

0486 "=S" (addr), "=c" (cnt) : 

0487 "d" (port), "0" (addr), "1" (cnt) : 
"cc") ; 

} 

0490 

0491 static inline void 

0492 stosb(void *addr, int data, int cnt) 

0493 { 

0494 asm volatile ("eld; rep stosb" : 

0495 "=D" (addr), "=c" (cnt) : 

0496 "0" (addr), "1" (cnt), "a" (data) : 

0497 "memory", "cc"); 



0499 



Sheet 04 



Aug 29 17:09 2014 xv6/x86.h Page 2 



0500 static inline void 

0501 stosl(void *addr, int data, int cnt) 

0502 { 

0503 asm volatile ("eld; rep stosl" : 

0504 "=D" (addr), "=c" (cnt) : 

0505 "0" (addr), "1" (cnt), "a" (data) : 

0506 "memory", "cc"); 

0507 } 
0508 

0509 struct segdesc; 
0510 

0511 static inline void 

0512 Igdt (struct segdesc *p, int size) 

0513 { 

0514 volatile ushort pd[3] ; 
0515 

0516 pd[0] = size-1; 

0517 pd[l] = (uint)p; 

0518 pd[2] = (uint)p » 16; 

0519 

0520 asm volatile ("Igdt (%0)" : : "r" (pd) ) ; 

0521 } 
0522 

0523 struct gatedesc; 
0524 

0525 static inline void 

0526 lidt (struct gatedesc *p, int size) 

0527 { 

0528 volatile ushort pd[3]; 

0529 

0530 pd[0] = size-1; 

0531 pd[l] = (uint)p; 

0532 pd[2] = (uint)p » 16; 
0533 

0534 asm volatile ("lidt (%0)" : : "r" (pd) ) ; 

0535 } 
0536 

0537 static inline void 

0538 Itr (ushort sel) 

0539 { 

0540 asm volatile ("Itr %0" : : "r" (sel)); 

0541 } 
0542 

0543 static inline uint 

0544 readef lags (void) 

0545 { 

0546 uint eflags; 

0547 asm volatile ("pushfl; popl %0" : "=r" (eflags)); 

0548 return eflags; 

0549 } 
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0550 static inline void 

0551 loadgs (ushort v) 

0552 { 

0553 asm volatile ("movw %0, %%gs" : : "r" (v) ) ; 

0554 } 
0555 

0556 static inline void 

0557 cli(void) 

0558 { 

0559 asm volatile ("cli") ; 

0560 } 
0561 

0562 static inline void 

0563 sti(void) 

0564 { 

0565 asm volatile ("sti") ; 

0566 ) 
0567 

0568 static inline uint 

0569 xchg (volatile uint *addr, uint newval) 

0570 { 

0571 uint result; 
0572 

0573 // The + in "+m" denotes a read-modify-write operand. 

0574 asm volatile ("lock; xchgl %0, %1" : 

0575 "+m" (*addr), "=a" (result) : 

0576 "1" (newval) : 

0577 "cc"); 

0578 return result; 

0579 ) 
0580 

0581 static inline uint 

0582 rcr2 (void) 

0583 { 

0584 uint val; 

0585 asm volatile ("movl %%cr2,%0" : "=r" (val)); 

0586 return val; 

0587 ) 
0588 

0589 static inline void 

0590 lcr3(uint val) 

0591 { 

0592 asm volatile ("movl %0,%%cr3" : : "r" (val)); 

0593 } 
0594 
0595 
0596 
0597 
0598 
0599 
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0600 // Layout of the trap frame built on the stack by the 

0601 // hardware and by trapasm.S, and passed to trapO . 

0602 struct trapframe { 

0603 // registers as pushed by pusha 

0604 uint edi; 

0605 uint esi; 

0606 uint ebp; 

0607 uint oesp; // useless & ignored 

0608 uint ebx; 

0609 uint edx; 

0610 uint ecx; 

0611 uint eax; 
0612 

0613 // rest of trap frame 

0614 ushort gs; 

0615 ushort paddingl; 

0616 ushort fs; 

0617 ushort padding2; 

0618 ushort es; 

0619 ushort padding3; 
0520 ushort ds; 

0621 ushort padding4; 

0622 uint trapno; 
0623 

0624 // below here defined by x86 hardware 

0625 uint err; 

0626 uint eip; 

0627 ushort cs; 

0628 ushort padding5; 
062 9 uint eflags; 
0630 

0631 // below here only when crossing rings, such as from user to kernel 

0632 uint esp; 

0633 ushort ss; 

0634 ushort padding6; 

0635 }; 
0636 
0637 
0638 
0639 
0640 
0641 
0642 
0643 
0644 
0645 
0646 
0647 
0648 
0649 
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#def ine 


STA_ 


_X 


0x8 


#def ine 


STA_ 


_E 


0x4 


#def ine 


STA_ 


_C 


0x4 


#def ine 


STA_ 


J 


0x2 


#def ine 


STA. 


.R 


0x2 


#def ine 


STA. 


.A 


0x1 



0650 // 

0651 // assembler macros to create x86 segments 

0652 // 
0653 

0654 #define SEG_NULLASM \ 

0655 .word 0, 0; \ 

0656 .byte 0, 0, 0, 0 
0657 

0658 // The OxCO means the limit is in 4096-byte units 

0659 // and (for executable segments) 32-bit mode. 

0660 tdefine SEG_ASM (type, base, lim) \ 

0661 .word (((lim) » 12) & Oxffff ) , ((base) & Oxf f ff ) ; \ 

0662 .byte (((base) » 16) S Oxf f ) , (0x90 t (type)), \ 

0663 (OxCO I (((lim) » 28) S Oxf)), (((base) » 24) & Oxff) 
0664 

0665 tdefine STA_X 0x8 // Executable segment 

// Expand down (non-executable segments) 
0667 tdefine STA_C 0x4 // Conforming code segment (executable only) 

// Writeable (non-executable segments) 
// Readable (executable segments) 
0670 tdefine STA_A 0x1 // Accessed 

0671 
0672 
0673 
0674 
0675 
0676 
0677 
0678 
0679 
0680 
0681 
0682 
0683 
0684 
0685 
0686 
0687 
0688 
0689 
0690 
0691 
0692 
0693 
0694 
0695 
0696 
0697 
0698 
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0700 // This file contains definitions for the 

0701 // x85 memory management unit (MMU) . 
0702 

0703 // Eflags register 



0704 


#def ine 


FL. 


.CF 




0x00000001 


// 


Carry Flag 


0705 


♦define 


FL. 


.PF 




0x00000004 


// 


Parity Flag 


0706 


♦define 


FL. 


-AF 




0x00000010 


// 


Auxiliary carry Flag 


0707 


♦define 


FL. 


-ZF 




0x00000040 


// 


Zero Flag 


0708 


♦define 


FL. 


.SF 




0x00000080 


// 


Sign Flag 


0709 


♦define 


FL. 


.TF 




0x00000100 


// 


Trap Flag 


0710 


#def ine 


FL_ 


_IF 




0x00( 


)00200 


// 


Interrupt Enable 


0711 


#def ine 


FL_ 


_DF 




0x00( 


J00400 


// 


Direction Flag 


0712 


♦define 


FL_ 


_0F 




0x00( 


300800 


// 


Overflow Flag 


0713 


♦define 


FL_ 


_IOPL_ 


.MASK 


0x00( 


)03000 


// 


I/O Privilege Level bitmask 


0714 


♦define 


FL_ 


_IOPL_ 


_0 


0x00( 


)00000 


// 


lOPL == 0 


0715 


♦define 


FL_ 


_IOPL_ 


_1 


0x00( 


)01000 


// 


lOPL == 1 


0716 


♦define 


FL_ 


_IOPL_ 


_2 


0x00( 


J02000 


// 


lOPL == 2 


0717 


♦define 


FL_ 


_IOPL. 


.3 


0x00( 


303000 


// 


lOPL == 3 


0718 


♦define 


FL_ 


_NT 




OxOO( 


)04000 


// 


Nested Task 


0719 


♦define 


FL. 


.RF 




OxOO( 


noooo 


// 


Resume Flag 


0720 


♦define 


FL. 


.VM 




OxOO( 


320000 


// 


Virtual 8086 mode 


0721 


♦define 


FL. 


.AC 




0x00040000 


// 


Alignment Check 


0722 


♦define 


FL. 


.VIF 




0x00080000 


// 


Virtual Interrupt Flag 


0723 


♦define 


FL. 


.VIP 




0x00100000 


// 


Virtual Interrupt Pending 


0724 


♦define 


FL. 


-ID 




0x00200000 


// 


ID flag 



0725 

0726 // Control Register flags 



0727 


♦define 


CRO. 


.PE 






0x00000001 


// 


Protection Enable 


0728 


♦define 


CRO. 


.MP 






0x00000002 


// 


Monitor coprocessor 


0729 


♦define 


CRO_ 


_EM 






0x00000004 


// 


Emulation 


0730 


♦define 


CRO_ 


_TS 






0x00000008 


// 


Task Switched 


0731 


♦define 


CRO_ 


_ET 






0x00000010 


// 


Extension Type 


0732 


♦define 


CRO_ 


_NE 






0x00000020 


// 


Numeric Errror 


0733 


♦define 


CRO_ 


_WP 






0x00010000 


// 


Write Protect 


0734 


♦define 


CRO_ 


_AM 






0x00040000 


// 


Alignment Mask 


0735 


♦define 


CRO. 


.NW 






0x20000000 


// 


Not Writethrough 


0736 


♦define 


CRO. 


.CD 






0x40000000 


// 


Cache Disable 


0737 
0738 


♦define 


CRO. 


.PG 






0x80000000 


// 


Paging 


0739 


♦define 


CR4. 


.PSE 






0x00000010 


// 


Page size extension 


0740 


















0741 


♦define 


SEG. 


.KCODE 


1 


// 


kernel code 






0742 


♦define 


SEG. 


.KDATA 


2 


// 


kernel data+stack 




0743 


♦define 


SEG. 


.KCPU 


3 


// 


kernel per-cpu 


data 


0744 


♦define 


SEG. 


.UCODE 


4 


// 


user code 






0745 


♦define 


SEG. 


.UDATA 


5 


// 


user data+stack 




0746 


♦define 


SEG. 


.TSS 


6 


// 


this process's 


task state 



0747 
0748 
0749 
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0750 lifndef ASSEMBLER 

0751 // Segment Descriptor 



0752 


struct 


segdesc ( 








0753 


uint 


lim_15_0 : 


16; 


// 


Low bits of segment limit 


0754 


uint 


base_15_0 : 


16; 


// 


Low bits of segment base address 


0755 


uint 


base_23_16 


: 8; 


// 


Middle bits of segment base address 


0756 


uint 


type : 4; 




// 


Segment type (see STS_ constants) 


0757 


uint 


s : 1; 




// 


0 = system, 1 = application 


0758 


uint 


dpi : 2; 




// 


Descriptor Privilege Level 


0759 


uint 


P : 1; 




// 


Present 


0760 


uint 


lim_19_16 : 


4; 


// 


High bits of segment limit 


0761 


uint 


avl : 1; 




// 


Unused (available for software use) 


0762 


uint 


rsvl : 1; 




// 


Reserved 


0763 


uint 


db : 1; 




// 


0 = 16-bit segment, 1 = 32-bit segment 


0764 


uint 


g : 1; 




// 


Granularity: limit scaled by 4K when set 


0765 


uint 


base_31_24 


: 8; 


// 


High bits of segment base address 



0766 ); 
0767 

0768 // Normal segment 

0769 tdefine SEG (type, base, lim, dpi) (struct segdesc) \ 

0770 { (dim) » 12) S Oxffff, (uint) (base) S Oxffff, \ 

0771 ( (uint) (base) » 16) & Oxff, type, 1, dpi, 1, \ 

0772 (uint) (lim) » 28, 0, 0, 1, 1, (uint) (base) » 24 } 

0773 #define SEG16(type, base, lim, dpi) (struct segdesc) \ 

0774 { (lim) & Oxffff, (uint) (base) & Oxffff, \ 

0775 ( (uint) (base) » 16) S Oxff, type, 1, dpi, 1, \ 

0776 (uint) (lim) » 16, 0, 0, 1, 0, (uint) (base) » 24 } 

0777 #endif 
0778 

0779 #define DPL_USER 0x3 // User DPL 

0780 

0781 // Application segment type bits 



782 


♦define 


STA_ 


_X 


0x8 


// 


Executable segment 


783 


♦define 


STA_ 


_E 


0x4 


// 


Expand down (non-executable segments) 


784 


♦define 


STA_ 


_C 


0x4 


// 


Conforming code segment (executable only) 


785 


♦define 


STA_ 


_W 


0x2 


// 


Writeable (non-executable segments) 


786 


♦define 


STA. 


.R 


0x2 


// 


Readable (executable segments) 


787 


♦define 


STA. 


.A 


0x1 


// 


Accessed 



0788 

0789 // System segment type bits 



0790 


♦define 


STS. 


.T16A 


0x1 


// 


Available 16-bit 


TSS 


0791 


♦define 


STS. 


.LDT 


0x2 


// 


Local Descriptor Table 


0792 


♦define 


STS. 


.T16B 


0x3 


// 


Busy 16-bit TSS 




0793 


♦define 


STS. 


.CGI 6 


0x4 


// 


16-bit Call Gate 




0794 


♦define 


STS. 


.TG 


0x5 


// 


Task Gate / Coum 


Transmitions 


0795 


♦define 


STS. 


.IG16 


0x6 


// 


16-bit Interrupt 


Gate 


0796 


♦define 


STS. 


.TGI 6 


0x7 


// 


16-bit Trap Gate 




0797 


♦define 


STS_ 


_T32A 


0x9 


// 


Available 32-bit 


TSS 


0798 


♦define 


STS_ 


_T32B 


OxB 


// 


Busy 32-bit TSS 




0799 


♦define 


STS. 


.CG32 


OxC 


// 


32-bit Call Gate 
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0800 #define STS_IG32 OxE // 32-bit Interrupt Gate 

0801 #define STS_TG32 OxF // 32-bit Trap Gate 
0802 

0803 // A virtual address 'la' has a three-part structure as follows: 

0804 // 

0805 // + 10 + 10 + 12 + 

0806 // I Page Directory | Page Table | Offset within Page | 

0807 // I Index | Index | I 

0808 // + + + + 

0809 // \— PDX(va) — / \— PTX(va) — / 
0810 

0811 // page directory index 

0812 tdefine PDX(va) (((uint)(va) » PDXSHIFT) s 0x3FF) 

0813 

0814 // page table index 

0815 #define PTX(va) (((uint)(va) » PTXSHIFT) & 0x3FF) 
0816 

0817 // construct virtual address from indexes and offset 

0818 #define PGADDR(d, t, o) ((uint)((d) « PDXSHIFT | (t) « PTXSHIFT | (o) ) ) 

0819 

0820 // Page directory and page table constants. 

0821 tdefine NPDENTRIES 1024 // # directory entries per page directory 

0822 tdefine NPTENTRIES 1024 // t PTEs per page table 

0823 tdefine PGSIZE 4096 // bytes mapped by a page 
0824 



0825 


tdefine 


PGSHIFT 


12 


// log2 (PGSIZE) 


0826 


tdefine 


PTXSHIFT 


12 


// offset of PTX in , 


0827 


tdefine 


PDXSHIFT 


22 


// offset of PDX in , 


0828 










0829 


#def ine 


PGROUNDUP (sz) 


(((sz)- 


fPGSIZE-1) S ~(PGSIZE-1 


0830 


#def ine 


PGROUNDDOWN(a) 


(((a)) 


& ~(PGSIZE-1)) 


0831 










0832 


// Page 


table/directory entry flags. 


0833 


#def ine 


PTE_P 


0x001 


// Present 


0834 


#def ine 


PTE_W 


0x002 


// Writeable 


0835 


#def ine 


PTE_U 


0x004 


// User 


0836 


#def ine 


PTE_PWT 


0x008 


// Write-Through 


0837 


#def ine 


PTE_PCD 


0x010 


// Cache-Disable 


0838 


tdefine 


PTE_A 


0x020 


// Accessed 


0839 


tdefine 


PTE_D 


0x040 


// Dirty 


0840 


tdefine 


PTE_PS 


0x080 


// Page Size 


0841 


tdefine 


PTE_MBZ 


0x180 


// Bits must be zero 



0842 

0843 // Address in page table or page directory entry 

0844 tdefine PTE_ADDR(pte) ( (uint) (pte) S -OxFFF) 

0845 tdefine PTE_FLAGS(pte) ( (uint) (pte) & OxFFF) 
0846 

0847 tifndef ^ASSEMBLER 

0848 typedef uint pte_t; 
0849 
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0850 
0851 
0852 
0853 
0854 
0855 
0856 
0857 
0858 
0859 
0860 
0861 
0862 
0863 
0864 
0865 
0866 
0867 
0868 
0869 
0870 
0871 
0872 
0873 
0874 
0875 
0876 
0877 
0878 
0879 
0880 
0881 
0882 
0883 
0884 
0885 
0886 
0887 
0888 
0889 
0890 
0891 
0892 
0893 
0894 
0895 
0896 
0897 



// Task state segment format 
struct taskstate { 

uint link; 

uint espO; 

ushort ssO; 

ushort paddingl; 

uint *espl; 

ushort ssl; 

ushort padding2; 

uint *esp2; 

ushort ss2; 

ushort padding3; 

void *cr3; 



uint *eip; 
uint eflags; 
uint eax; 
uint ecx; 
uint edx; 
uint ebx; 
uint *esp; 
uint *ebp; 
uint esi; 
uint edi; 
ushort es; 
ushort padding4; 
ushort cs; 
ushort paddingS; 
ushort ss; 
ushort padding6; 
ushort ds; 
ushort padding?; 
ushort fs; 
ushort padding8; 
ushort gs; 
ushort padding9; 
ushort Idt; 
ushort paddinglO; 
ushort t; 
ushort iomb; 



}; 



// Old ts selector 

// Stack pointers and segment selectors 
// after an increase in privilege level 



// Page directory base 
// Saved state from last task switch 

// More saved state (registers) 



// Even more saved state (segment selectors) 



// Trap on task switch 
// I/O map base address 
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0900 
0901 
0902 
0903 
0904 
0905 
0906 
0907 
0908 
0909 
0910 
0911 
0912 
0913 
0914 
0915 
0916 
0917 
0918 
0919 
0920 
0921 
0922 
0923 
0924 
0925 
0926 
0927 
0928 
0929 
0930 
0931 
0932 
0933 
0934 
0935 
0936 
0937 
0938 
0939 
0940 
0941 
0942 
0943 
0944 
0945 
0946 
0947 
0948 
0949 



// Gate descriptors for interrupts and traps 
struct gatedesc ( 

uint off_15_0 : 16; 

uint OS : 16; 



uint args 
uint rsvl 



// 
// 
// 
// 



uint type : 
uint s : 1; 
uint dpi : 2; 
uint p : 1; 
uint off 31 16 



16; 



low 16 bits of offset in segment 
code segment selector 
# args, 0 for interrupt/trap gates 
reserved (should be zero I guess) 
// type(STS_{TG,IG32,TG32}) 
// must be 0 (system) 

// descriptor (meaning new) privilege level 
// Present 

// high bits of offset in segment 



Set up a normal interrupt/trap gate descriptor. 

- istrap: 1 for a trap (= exception) gate, 0 for an interrupt gate, 
interrupt gate clears FL_IF, trap gate leaves FL_IF alone 



sel 
off 
dpi 



Code segment selector for interrupt/trap handler 
Offset in code segment for interrupt/trap handler 
Descriptor Privilege Level - 

the privilege level required for software to invoke 

this interrupt/trap gate explicitly using an int instruction. 



tdefine SETGATE (gate, istrap, sel, off, d) 
{ 

(gate) .off_15_0 = (uint) (off) & Oxffff; 
(gate) . cs = (sel) ; 
(gate) .args = 0; 
(gate) .rsvl = 0; 
(gate) .type = (istrap) 
(gate) .s = 0; 
(gate) .dpi = (d) ; 
(gate) .p = 1; 

(gate) .off_31_16 = (uint) (off) » 16; 



#endif 



STS_TG32 : STS_IG32; 
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0950 // Format of an ELF executable file 
0951 

0952 tdefine ELF_MAGIC 0x464C457FU // "\x7FELF" in little endian 
0953 

0954 // File header 

0955 struct elfhdr { 

0956 uint magic; // must equal ELF_MAGIC 

0957 uchar elf [12]; 

0958 ushort type; 

0959 ushort machine; 

0960 uint version; 

0961 uint entry; 

0962 uint phoff; 

0963 uint shoff; 

0964 uint flags; 

0965 ushort ehsize; 

0966 ushort phentsize; 

0967 ushort phnum; 

0968 ushort shentsize; 

0969 ushort shnum; 

0970 ushort shstrndx; 

0971 }; 
0972 

0973 // Program section header 

0974 struct proghdr { 

0975 uint type; 

0976 uint off; 

0977 uint vaddr; 

0978 uint paddr; 

0979 uint filesz; 

0980 uint memsz; 

0981 uint flags; 

0982 uint align; 

0983 ); 
0984 

0985 // Values for Proghdr type 

0986 tdefine ELF_PROG_LOAD 1 
0987 

0988 // Flag bits for Proghdr flags 

0989 tdefine ELF_PROG_FLAG_EXEC 1 

0990 tdefine ELF_PROG_FLAG_WRITE 2 

0991 tdefine ELF_PROG_FLAG_READ 4 
0992 

0993 
0994 
0995 
0996 
0997 
0998 
0999 
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1000 # Multiboot header, for multiboot boot loaders like GNU Grub. 

1001 # http: / /www. gnu.org/software/grub/manual /multiboot /multiboot .html 

1002 # 

1003 # Using GRUB 2, you can boot xv6 from a file stored in a 

1004 # Linux file system by copying kernel or kernelmemfs to /boot 

1005 # and then adding this menu entry: 

1006 # 

1007 # menuentry "xv6" { 

1008 # insmod ext2 

1009 # set root=' (hd0,msdosl) ' 

1010 # set kernel=' /boot/kernel' 

1011 # echo "Loading ${kernel}..." 

1012 # multiboot ${kernel} ${kernel} 

1013 # boot 

1014 # } 
1015 

1016 #include "asm.h" 

1017 #include "memlayout.h" 

1018 #include "mmu.h" 

1019 #include "param.h" 
1020 

1021 # Multiboot header. Data to direct multiboot loader. 

1022 .p2align 2 

1023 .text 

1024 .globl multiboot_header 

1025 multiboot_header : 

1026 tdefine magic Oxlbadb002 

1027 tdefine flags 0 

1028 . long magic 

1029 .long flags 

1030 .long (-magic-flags) 
1031 

1032 # By convention, the _start symbol specifies the ELF entry point. 

1033 # Since we haven't set up virtual memory yet, our entry point is 

1034 # the physical address of 'entry'. 

1035 .globl _start 

1036 _start = V2P_W0 (entry) 
1037 

1038 # Entering xv6 on boot processor, with paging off. 

1039 .globl entry 

1040 entry: 

1041 # Turn on page size extension for 4Mbyte pages 

1042 movl %cr4, %eax 

1043 orl $(CR4_PSE), %eax 

1044 movl %eax, %cr4 

1045 # Set page directory 

104 6 movl $ (V2P_W0(entrypgdir) ) , %eax 

1047 movl %eax, %cr3 

1048 # Turn on paging. 

1049 movl %crO, %eax 
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1050 orl $ (CR0_PG1CR0_WP) , %eax 

1051 movl %eax, %crO 
1052 

1053 # Set up the stack pointer. 

1054 movl $ (stack + KSTACKSIZE), %esp 
1055 

1056 # Jump to mainO, and switch to executing at 

1057 # high addresses. The indirect call is needed because 

1058 # the assembler produces a PC-relative instruction 

1059 # for a direct jump. 

1060 mov $main, %eax 

1061 jmp *%eax 
1062 

1063 .coram stack, KSTACKSIZE 

1064 

1065 

1066 

1067 

1068 

1069 

1070 

1071 

1072 

1073 

1074 

1075 

1076 

1077 

1078 

1079 

1080 

1081 

1082 

1083 

1084 

1085 

1086 

1087 

1088 

1089 

1090 

1091 

1092 

1093 

1094 

1095 

1096 

1097 

1098 

1099 
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1100 #include "asm.h" 

1101 #include "memlayout .h" 

1102 tinclude "mmu.h" 
1103 

1104 # Each non-boot CPU ("AP") is started up in response to a STARTUP 

1105 # IPI from the boot CPU. Section B.4.2 of the Multi-Processor 

1106 # Specification says that the AP will start in real mode with CS:IP 

1107 # set to XYOO:0000, where XY is an 8-bit value sent with the 

1108 # STARTUP. Thus this code must start at a 4096-byte boundary. 

1109 # 

1110 # Because this code sets DS to zero, it must sit 

1111 # at an address in the low 2^16 bytes. 

1112 # 

1113 # Startothers (in main.c) sends the STARTUPS one at a time. 

1114 # It copies this code (start) at 0x7000. It puts the address of 

1115 # a newly allocated per-core stack in start-4,the address of the 

1116 # place to jump to (mpenter) in start-8, and the physical address 

1117 # of entrypgdir in start-12. 

1118 # 

1119 # This code is identical to bootasm.S except: 

1120 # - it does not need to enable A20 

1121 # - it uses the address at start-4, start-8, and start-12 
1122 

1123 .codeie 

1124 .globl start 

1125 start: 

1126 cli 
1127 

1128 xorw 

112 9 movw 

1130 movw 

1131 movw 
1132 

1133 Igdt 

1134 movl 

1135 orl 

1136 movl 
1137 
1138 
1139 
1140 
1141 
1142 
1143 
1144 
1145 
1146 
1147 
1148 
1149 
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%crO, %eax 
$CRO_PE, %eax 
%eax, %crO 



Aug 29 17:09 2014 xv6/entryother.S Page 2 



1150 


1 jmpl 


$(SEG_KC0DE«3), $(start32) 


1151 






1152 


. code32 




1153 


start32: 




1154 


movw 


$ (SEG_KDATA«3) , %ax 


1155 


movw 


%ax, %ds 


1156 


movw 


%ax, %es 


1157 


movw 


"5 ax, -gss 


1158 


movw 


$0, %ax 


1159 


movw 


%ax, %fs 


1160 


movw 


%ax, %gs 


1161 






1162 


# Turn 


on page size extension for 4Mbyte pages 


1163 


movl 


%cr4, %eax 


1164 


orl 


$(CR4_PSE), %eax 


1165 


movl 


%eax, %cr4 


1166 


# Use 


enterpgdir as our initial page table 


1167 


movl 


(start-12), %eax 


1168 


movl 


%eax, %cr3 


1169 


# Turn 


on paging. 


1170 


movl 


%crO, %eax 


1171 


orl 


$(CR0_PE1CR0_PG|CR0_WP), %eax 


1172 


movl 


%eax, %crO 


1173 






1174 


# Switch to the stack allocated by startothers 


1175 


movl 


(start-4), %esp 


1176 


# Call mpenter 0 


1177 


call 


* (start-8) 


1178 






1179 


movw 


$0x8a00, %ax 


1180 


movw 


%ax, %dx 


1181 


outw 


%ax, %dx 


1182 


movw 


$0x8ae0, %ax 


1183 


outw 


%ax, %dx 


1184 


spin: 




1185 


jmp 


spin 


1186 






1187 


.p2align 2 


1188 


gdt: 




1189 


SEG_NULLASM 


1190 


SEG_ASM(STA_X|STA_R, 0, Oxffffffff) 


1191 


SEG_ASM(STA_W, 0, Oxffffffff) 


1192 






1193 






1194 


gdtdesc: 




1195 


.word 


(gdtdesc - gdt - 1) 


1196 


. long 


gdt 


1197 






1198 






1199 
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1200 #include "types. h" 

1201 #include "defs.h" 

1202 tinclude "param.h" 

1203 tinclude "memlayout .h" 

1204 tinclude "mmu.h" 

1205 tinclude "proc.h" 

1206 tinclude "x86.h" 
1207 

1208 static void startothers (void) ; 

1209 static void rapmain(void) attribute ( (noreturn) ) ; 

1210 extern pde_t *kpgdir; 

1211 extern char end[]; // first address after kernel loaded from ELF file 
1212 

1213 // Bootstrap processor starts running C code here. 

1214 // Allocate a real stack and switch to it, first 

1215 // doing some setup required for memory allocator to work. 



1216 


int 






1217 


main (void) 






1218 


{ 






1219 


kinitKend, P2V(4 


*1( 


)24*1024)); // phys page allocator 


1220 


kvmalloc () ; 


// 


kernel page table 


1221 


mpinit () ; 


// 


collect info about this machine 


1222 


lapicinit () ; 






1223 


seginit () ; 


// 


set up segments 


1224 


cprintf ("\ncpu%d: 


starting xv6\n\n", cpu->id) ; 


1225 


picinit 0 ; 


// 


interrupt controller 


1226 


ioapicinit () ; 


// another interrupt controller 


1227 


consoleinit () ; 


// 


I/O devices & their interrupts 


1228 


uartinit () ; 


// 


serial port 


1229 


pinit 0 ; 


// 


process table 


1230 


tvinit ( ) ; 


// 


trap vectors 


1231 


binit 0 ; 


// 


buffer cache 


1232 


f ileinit () ; 


// 


file table 


1233 


iinit 0 ; 


// 


inode cache 


1234 


ideinit ( ) ; 


// 


disk 


1235 


if ( ! ismp) 






1236 


timerinit ( ) ; 


// 


uniprocessor timer 


1237 


startothers ( ) ; 


// 


start other processors 


1238 


kinit2 (P2V(4*1024 


*1( 


)24), P2V(PHYST0P) ) ; // must come after 


1239 


userinit () ; 


// 


first user process 


1240 


// Finish setting up this processor in mpmain. 


1241 


mpmain 0 ; 






1242 


} 






1243 








1244 








1245 








1246 








1247 








1248 








1249 
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1250 // Other CPUs jump here from entryother.S. 

1251 static void 

1252 mpenter (void) 

1253 { 

1254 switchkvmO; 

1255 seginit 0 ; 

1256 lapicinit 0; 

1257 mpmain 0; 

1258 } 
1259 

1260 // Common CPU setup code. 

1261 static void 

1262 mpmain (void) 

1263 { 

1264 cprintf ("cpu%d: starting\n", cpu->id) ; 

1265 idtinitO; // load idt register 

1266 xchg (&cpu->started, 1); // tell startothers () we're up 

1267 schedulerO; // start running processes 

1268 } 
1269 

1270 pde_t entrypgdir[] ; // For entry. S 

1271 

1272 // Start the non-boot (AP) processors. 

1273 static void 

1274 startothers (void) 

1275 { 

1276 extern uchar _binary_entryother_start [] , _binary_entryother_size[] ; 

1277 uchar *code; 

1278 struct cpu *c; 

1279 char *stack; 

1280 

1281 // Write entry code to unused memory at 0x7000. 

1282 // The linker has placed the image of entryother.S in 

1283 // _binary_entryother_start . 

1284 code = p2v(0x7000); 

1285 memmo ve ( code , _binary_entryother_start, (uint)_binary_entryother_size) 

1286 

1287 for(c = opus; c < cpus+ncpu; C++) { 

1288 if(c == cpus+cpunum() ) // We've started already. 

1289 continue; 
1290 

1291 // Tell entryother.S what stack to use, where to enter, and what 

1292 // pgdir to use. We cannot use kpgdir yet, because the AP processor 

1293 // is running in low memory, so we use entrypgdir for the APs too. 

1294 stack = kallocO ; 

1295 *(void**) (code-4) = stack + KSTACKSIZE; 

1296 * (void**) (code-8) = mpenter; 

1297 * (int**) (code-12) = (void*) v2p (entrypgdir) ; 
1298 

1299 lapicstartap (c->id, v2p(code)); 
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1300 // wait for cpu to finish mpmain() 

1301 while (c->started == 0) 

1302 ; 

1303 } 

1304 } 
1305 

1306 // Boot page table used in entry. S and entryother.S. 

1307 // Page directories (and page tables), must start on a page boundary, 

1308 // hence the " aligned " attribute. 

1309 // Use PTE_PS in page directory entry to enable 4Mbyte pages. 

1310 _attribute_( (_aligned_(PGSIZE) ) ) 

1311 pde_t entrypgdir[NPDENTRIES] = { 

1312 // Map VA's [0, 4MB) to PA' s [0, 4MB) 

1313 [0] = (0) I PTE_P I PTE_W | PTE_PS, 

1314 // Map VA's [KERNBASE, KERNBASE+4MB) to PA'S [0, 4MB) 

1315 [KERNBASE»PDXSHIFT] = (0) | PTE_P | PTE_W | PTE_PS, 

1316 }; 
1317 
1318 
1319 
1320 
1321 
1322 
1323 
1324 
1325 
1326 
1327 
1328 
1329 
1330 
1331 
1332 
1333 
1334 
1335 
1336 
1337 
1338 
1339 
1340 
1341 
1342 
1343 
1344 
1345 
1346 
1347 
1348 
1349 
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1350 // Blank page. 

1351 
1352 
1353 
1354 
1355 
1356 
1357 
1358 
1359 
1360 
1361 
1362 
1363 
1364 
1365 
1366 
1367 
1368 
1369 
1370 
1371 
1372 
1373 
1374 
1375 
1376 
1377 
1378 
1379 
1380 
1381 
1382 
1383 
1384 
1385 
1386 
1387 
1388 
1389 
1390 
1391 
1392 
1393 
1394 
1395 
1396 
1397 
1398 
1399 
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1400 // Blank page. 


1450 // Blank page 


1401 


1451 


1402 


1452 


1403 


1453 


1404 


1454 


1405 


1455 


1406 


1456 


1407 


1457 


1408 


1458 


1409 


1459 


1410 


1460 


1411 


1461 


1412 


1462 


1413 


1463 


1414 


1464 


1415 


1465 


1416 


1466 


1417 


1467 


1418 


1468 


1419 


1469 


1420 


1470 


1421 


1471 


1422 


1472 


1423 


1473 


1424 


1474 


1425 


1475 


1426 


1476 


1427 


1477 


1428 


1478 


1429 


1479 


1430 


1480 


1431 


1481 


1432 


1482 


1433 


1483 


1434 


1484 


1435 


1485 


1436 


1486 


1437 


1487 


1438 


1488 


1439 


1489 


1440 


1490 


1441 


1491 


1442 


1492 


1443 


1493 


1444 


1494 


1445 


1495 


1446 


1496 


1447 


1497 


1448 


1498 


1449 


1499 
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1500 // Mutual exclusion lock. 

1501 struct spinlock { 

1502 uint locked; // Is the lock held? 
1503 

1504 // For debugging: 

1505 char *name; // Name of lock. 

1506 struct cpu *cpu; // The cpu holding the lock. 

1507 uint pes [10]; // The call stack (an array of program counters) 

1508 // that locked the lock. 

1509 }; 
1510 
1511 
1512 
1513 
1514 
1515 
1516 
1517 
1518 
1519 
1520 
1521 
1522 
1523 
1524 
1525 
1526 
1527 
1528 
1529 
1530 
1531 
1532 
1533 
1534 
1535 
1536 
1537 
1538 
1539 
1540 
1541 
1542 
1543 
1544 
1545 
1546 
1547 
1548 
1549 
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1550 // Mutual exclusion spin locks. 

1551 

1552 #include "types. h" 

1553 #include "defs.h" 

1554 #include "param.h" 

1555 #include "x86.h" 

1556 #include "memlayout.h" 

1557 #include "mmu.h" 

1558 #include "proc.h" 

1559 #include "spinlock. h" 
1560 

1561 void 

1562 initlock (struct spinlock *lk, char *name) 

1563 { 

1564 lk->name = name; 

1565 lk->locked = 0; 

1566 lk->cpu = 0; 

1567 } 
1568 

1569 // Acquire the lock. 

1570 // Loops (spins) until the lock is acquired. 

1571 // Holding a lock for a long time may cause 

1572 // other CPUs to waste time spinning to acquire it. 

1573 void 

1574 acquire (struct spinlock *lk) 

1575 { 

1576 pushcliO; // disable interrupts to avoid deadlock. 

1577 if (holding (Ik) ) 

1578 panic ("acquire") ; 

1579 

1580 // The xchg is atomic. 

1581 //It also serializes, so that reads after acquire are not 

1582 // reordered before it. 

1583 while (xchg (&lk->locked, 1) != 0) 

1584 

1585 

1586 // Record info about lock acquisition for debugging. 

1587 lk->cpu = cpu; 

1588 getcallerpcs (&lk, lk->pcs); 

1589 } 
1590 
1591 
1592 
1593 
1594 
1595 
1596 
1597 
1598 
1599 



Sheet 15 



Aug 29 17:09 2014 xv6/spinlock.c Page 2 



1600 // Release the lock. 

1601 void 

1602 release (struct spinlock *lk) 

1603 { 

1604 if (!holding(lk)) 

1605 panic ("release") ; 
1606 

1607 lk->pcs[0] = 0; 

1608 lk->cpu = 0; 
1609 

1610 // The xchg serializes, so that reads before release are 

1611 // not reordered after it. The 1996 PentiumPro manual (Volume 3, 

1612 // 7.2) says reads can be carried out speculatively and in 

1613 // any order, which implies we need to serialize here. 

1614 // But the 2007 Intel 64 Architecture Memory Ordering White 

1615 // Paper says that Intel 64 and IA-32 will not move a load 

1616 // after a store. So lock->locked = 0 would work here. 

1617 // The xchg being asm volatile ensures gcc emits it after 

1618 // the above assignments (and after the critical section) . 

1619 xchg(Slk->locked, 0); 
1620 

1621 popcliO; 

1622 } 
1623 

1624 // Record the current call stack in pcs[] by following the %ebp chain. 

1625 void 

1626 getcallerpcs (void *v, uint pcs[]) 

1627 { 

1628 uint *ebp; 

1629 int i; 
1630 

1631 ebp = (uint*)v - 2; 

1632 for(i = 0; i < 10; i++) { 

1633 if (ebp == 0 | | ebp < (uint*)KERNBASE || ebp == (uint*) Oxf f f f f f f f ) 

1634 break; 

1635 pcs[i] = ebp[l]; // saved %eip 

1636 ebp = (uint*) ebp [0] ; // saved %ebp 

1637 } 

1638 for(; i < 10; i++) 

1639 pcs[i] = 0; 

1640 } 
1641 

1642 // Check whether this cpu is holding the lock. 

1643 int 

1644 holding (struct spinlock *lock) 

1645 { 

1646 return lock->locked &S lock->cpu == cpu; 

1647 } 
1648 
1649 
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1650 // Pushcli/popcli are like cli/sti except that they are matched: 

1651 // it takes two popcli to undo two pushcli. Also, if interrupts 

1652 // are off, then pushcli, popcli leaves them off. 
1653 

1654 void 

1655 pushcli (void) 

1656 { 

1657 int eflags; 
1658 

1659 eflags = readeflags () ; 

1660 cliO; 

1661 if (cpu->ncli++ == 0) 

1662 cpu->intena = eflags S FL_IF; 

1663 ) 
1664 

1665 void 

1666 popcli (void) 

1667 { 

1668 if (readeflags 0 SFL_IF) 

1669 panic ("popcli - interruptible") ; 

1670 if (— cpu->ncli < 0) 

1671 panic ("popcli") ; 

1672 if(cpu->ncli == 0 S& cpu->intena) 

1673 sti(); 

1674 } 
1675 
1676 
1677 
1678 
1679 
1680 
1681 
1682 
1683 
1684 
1685 
1686 
1687 
1688 
1689 
1690 
1691 
1692 
1693 
1694 
1695 
1696 
1697 
1698 
1699 
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1700 #include "param.h" 

1701 #include "types. h" 

1702 tinclude "defs.h" 

1703 tinclude "x86.h" 

1704 tinclude "memlayout .h" 

1705 tinclude "mmu.h" 

1706 tinclude "proc.h" 

1707 tinclude "elf.h" 
1708 

1709 extern char data[]; // defined by kernel. Id 

1710 pde_t *kpgdir; // for use in scheduler () 

1711 struct segdesc gdt[NSEGS]; 
1712 

1713 // Set up CPU's kernel segment descriptors. 

1714 // Run once on entry on each CPU. 

1715 void 

1716 seginit (void) 

1717 { 

1718 struct cpu *c; 

1719 

1720 // Map "logical" addresses to virtual addresses using identity map. 

1721 // Cannot share a CODE descriptor for both kernel and user 

1722 // because it would have to have DPL_USR, but the CPU forbids 

1723 // an interrupt from CPL=0 to DPL=3. 

1724 c = Scpus [cpunumO ] ; 

1725 c->gdt [SEG_KCODE] = SEG(STA_X|STA_R, 0, Oxffffffff, 0); 

1726 c->gdt [SEG_KDATA] =SEG(STA_W, 0, Oxffffffff, 0); 

1727 c->gdt[SEG_UCODE] = SEG(STA_X|STA_R, 0, Oxffffffff, DPL_USER) ; 

1728 c->gdt [SEG_UDATA] =SEG(STA_W, 0, Oxffffffff, DPL_USER) ; 

1729 

1730 // Map cpu, and curproc 

1731 c->gdt[SEG_KCPU] = SEG(STA_W, &c->cpu, 8, 0); 

1732 

1733 lgdt(c->gdt, sizeof (c->gdt) ) ; 

1734 loadgs (SEG_KCPU « 3) ; 
1735 

1736 // Initialize cpu-local storage. 

1737 cpu = c; 

1738 proc = 0; 

1739 } 
1740 
1741 
1742 
1743 
1744 
1745 
1746 
1747 
1748 
1749 
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1750 // Return the address of the PTE in page table pgdir 

1751 // that corresponds to virtual address va. If alloc!=0, 

1752 // create any required page table pages. 

1753 static pte_t * 

1754 walkpgdir (pde_t *pgdir, const void *va, int alloc) 

1755 { 

1756 pde_t *pde; 

1757 pte_t *pgtab; 
1758 

1759 pde = Spgdir[PDX(va) ] ; 

1760 if (*pde S PTE_P) ( 

1761 pgtab = (pte_t*) p2v (PTE_ADDR (*pde) ) ; 

1762 ) else { 

1763 ifdalloc || (pgtab = (pte_t*) kalloc ( ) ) ==0) 

1764 return 0; 

1765 // Make sure all those PTE_P bits are zero. 

1766 memset (pgtab, 0, PGSIZE) ; 

1767 // The permissions here are overly generous, but they can 

1768 // be further restricted by the permissions in the page table 

1769 // entries, if necessary. 

1770 *pde = v2p (pgtab) | PTE_P | PTE_W | PTE_U; 

1771 } 

1772 return Spgtab[PTX(va) ] ; 

1773 } 
1774 

1775 // Create PTEs for virtual addresses starting at va that refer to 

1776 // physical addresses starting at pa. va and size might not 

1777 // be page-aligned. 

1778 static int 

1779 mappages (pde_t *pgdir, void *va, uint size, uint pa, int perm) 

1780 { 

1781 char *a, *last; 

1782 pte_t *pte; 
1783 

1784 a= (char*) PGROUNDDOWN( (uint) va) ; 

1785 last = (char*)PGROUNDDOWN( ( (uint)va) + size - 1); 

1786 for(;;){ 

1787 if((pte = walkpgdir (pgdir, a, 1)) == 0) 

1788 return -1; 

1789 if(*pte S PTE_P) 

1790 panic ("remap") ; 

1791 *pte = pa | perm | PTE_P; 

1792 if (a == last) 

1793 break; 

1794 a += PGSIZE; 

1795 pa += PGSIZE; 

1796 } 

1797 return 0; 

1798 ) 
1799 
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1800 // There is one page table per process, plus one that's used when 

1801 //a CPU is not running any process (kpgdir) . The kernel uses the 

1802 // current process's page table during system calls and interrupts; 

1803 // page protection bits prevent user code from using the kernel's 

1804 // mappings. 

1805 // 

1806 // setupkvmO and execO set up every page table like this: 

1807 // 

1808 // O..KERNBASE: user memory (text+data+stack+heap) , mapped to 

1809 // phys memory allocated by the kernel 

1810 // KERNBASE. .KERNBASE+EXTMEM: mapped to O..EXTMEM (for I/O space) 

1811 // KERNBASE+EXTMEM. .data: mapped to EXTMEM. . V2P (data) 

1812 // for the kernel's instructions and r/o data 

1813 // data. .KERNBASE+PHYSTOP: mapped to V2P (data) . .PHYSTOP, 

1814 // rw data + free physical memory 

1815 // OxfeOOOOOO . . 0 : mapped direct (devices such as ioapic) 

1816 // 

1817 // The kernel allocates physical memory for its heap and for user memory 

1818 // between V2P(end) and the end of physical memory (PHYSTOP) 

1819 // (directly addressable from end. .P2V (PHYSTOP) ) . 
1820 

1821 // This table defines the kernel's mappings, which are present in 

1822 // every process's page table. 

1823 static struct kmap { 

1824 void *virt; 

1825 uint phys_start; 

1826 uint phys_end; 

1827 int perm; 

1828 } kmap[] = { 

1829 ( (void*) KERNBASE, 0, EXTMEM, PTE_W}, // I/O space 

1830 { (void*)KERNIINK, V2P (KERNLINK) , V2P (data) , 0), // kern text+rodata 

1831 { (void*)data, V2P (data) , PHYSTOP, PTE_W), // kern data+memory 

1832 { (void*)DEVSPACE, DEVSPACE, 0, PTE_W}, // more devices 

1833 }; 
1834 

1835 // Set up kernel part of a page table. 

1836 pde_t* 

1837 setupkvm(void) 

1838 { 

1839 pde_t *pgdir; 

1840 struct kmap *k; 
1841 

1842 if((pgdir = (pde_t*) kalloc () ) == 0) 

1843 return 0; 

1844 memset (pgdir, 0, PGSIZE) ; 

1845 if (p2v(PHYST0P) > (void* ) DEVSPACE) 

1846 panic ("PHYSTOP too high") ; 

1847 for(k = kmap; k < Skmap [NELEM (kmap) ] ; k++) 

1848 if (mappages (pgdir, k->virt, k->phys_end - k->phys_start, 

1849 (uint) k->phys_start, k->perm) < 0) 
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1850 return 0; 

1851 return pgdir; 

1852 } 
1853 

1854 // Allocate one page table for the machine for the kernel address 

1855 // space for scheduler processes. 

1856 void 

1857 kvmalloc (void) 

1858 { 

1859 kpgdir = setupkvmO; 

1860 switchkvmO; 

1861 } 
1862 

1863 // Switch h/w page table register to the kernel-only page table, 

1864 // for when no process is running. 

1865 void 

1866 switchkvm(void) 

1867 { 

1868 lcr3 (v2p (kpgdir) ) ; // switch to the kernel page table 

1869 } 
1870 

1871 // Switch TSS and h/w page table to correspond to process p. 

1872 void 

1873 switchuvm (struct proc *p) 

1874 { 

1875 pushcliO; 

1876 cpu->gdt[SEG_TSS] = SEG16 (STS_T32A, &cpu->ts, sizeof (cpu->ts) -1, 

1877 cpu->gdt[SEG_TSS] .s = 0; 

1878 cpu->ts.ssO = SEG_KDATA « 3; 

1879 cpu->ts.espO = (uint) proc->kstack + KSTACKSIZE; 

1880 ltr(SEG_TSS « 3); 

1881 if(p->pgdir 0) 

1882 panic ("switchuvm: no pgdir"); 

1883 lcr3 (v2p (p->pgdir) ) ; // switch to new address space 

1884 popcliO; 

1885 ) 
1886 
1887 
1888 
1889 
1890 
1891 
1892 
1893 
1894 
1895 
1896 
1897 
1898 
1899 
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1900 // Load the initcode into address 0 of pgdir. 

1901 // sz must be less than a page. 

1902 void 

1903 inituvm (pde_t *pgdir, char *init, uint sz) 

1904 { 

1905 char *raem; 
1906 

1907 if (sz >= PGSIZE) 

1908 panic ("inituvm: more than a page"); 

1909 mem = kallocO ; 

1910 memsetfmem, 0, PGSIZE); 

1911 mappages (pgdir, 0, PGSIZE, v2p(mem), PTE_W | PTE_U) ; 

1912 memmove (mem, init, sz); 

1913 } 
1914 

1915 // Load a program segment into pgdir. addr must be page-aligned 

1916 // and the pages from addr to addr+sz must already be mapped. 

1917 int 

1918 loaduvm (pde_t *pgdir, char *addr, struct inode *ip, uint offset, 

1919 ( 

1920 uint i, pa, n; 

1921 pte_t *pte; 
1922 

1923 if ((uint) addr % PGSIZE != 0) 

1924 panic ("loaduvm: addr must be page aligned"); 

1925 for(i = 0; i < sz; i += PGSIZE) { 

1926 if((pte = walkpgdir (pgdir, addr+i, 0)) == 0) 

1927 panic ("loaduvm: address should exist"); 

1928 pa = PTE_ADDR(*pte) ; 

1929 if(sz - i < PGSIZE) 

1930 n = sz - i; 

1931 else 

1932 n = PGSIZE; 

1933 if(readi(ip, p2v(pa), offset+i, n) != n) 

1934 return -1; 

1935 } 

1936 return 0; 

1937 } 
1938 
1939 
1940 
1941 
1942 
1943 
1944 
1945 
1946 
1947 
1948 
1949 
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1950 // Allocate page tables and physical memory to grow process from oldsz to 

1951 // newsz, which need not be page aligned. Returns new size or 0 on error. 

1952 int 

1953 allocuvm (pde_t *pgdir, uint oldsz, uint newsz) 

1954 { 



1955 char *mem; 

1956 uint a; 
1957 

1958 if (newsz >= KERNBASE) 

1959 return 0; 

1960 if(newsz < oldsz) 

1961 return oldsz; 
1962 

1963 a = PGROUNDUP (oldsz) ; 

1964 for(; a < newsz; a += PGSIZE) { 

1965 mem = kalloc () ; 

1966 if (mem == 0) ( 

1967 cprintf ( "allocuvm out of memory\n"); 

1968 deallocuvm (pgdir, newsz, oldsz); 

1969 return 0; 

1970 } 

1971 memset(mem, 0, PGSIZE); 

1972 mappages (pgdir, (char*) a, PGSIZE, v2p(mem), PTE_W|PTE_U) ; 

1973 } 

1974 return newsz; 



1975 } 
1976 

1977 // Deallocate user pages to bring the process size from oldsz to 

1978 // newsz. oldsz and newsz need not be page-aligned, nor does newsz 

1979 // need to be less than oldsz. oldsz can be larger than the actual 

1980 // process size. Returns the new process size. 

1981 int 

1982 deallocuvm (pde_t *pgdir, uint oldsz, uint newsz) 

1983 { 



1984 pte_t *pte; 

1985 uint a, pa; 
1986 

1987 if (newsz >= oldsz) 

1988 return oldsz; 
1989 

1990 a = PGROUNDUP (newsz) ; 

1991 for(; a < oldsz; a += PGSIZE) { 

1992 pte = walkpgdir (pgdir, (char*) a, 0) ; 

1993 if(!pte) 

1994 a += (NPTENTRIES - 1) * PGSIZE; 

1995 else if((*pte S PTE_P) != 0) { 

1996 pa = PTE_ADDR(*pte) ; 

1997 if (pa == 0) 

1998 panic("kfree") ; 

1999 char *v = p2v(pa) ; 
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2000 kfree(v); 

2001 *pte = 0; 

2002 } 

2003 } 

2004 return newsz; 

2005 } 
2006 

2007 // Free a page table and all the physical memory pages 

2008 // in the user part. 

2009 void 

2010 freevm(pde_t *pgdir) 

2011 { 

2012 uint i; 
2013 

2014 if(pgdir == 0) 

2015 panic ( "freevm: no pgdir"); 

2016 deallocuvm (pgdir, KERNBASE, 0); 

2017 for(i = 0; 1 < NPDENTRIES; i++) { 

2018 if (pgdir [i] S PTE_P) { 

2019 char * v = p2v(PTE_ADDR(pgdir[i] ) ) ; 

2020 kfree(v); 

2021 } 

2022 } 

2023 kfree ( (char*) pgdir) ; 

2024 } 
2025 

2026 // Clear PTE_U on a page. Used to create an inaccessible 

2027 // page beneath the user stack. 

2028 void 

2029 clearpteu (pde_t *pgdir, char *uva) 

2030 { 

2031 pte_t *pte; 
2032 

2033 pte = walkpgdir (pgdir, uva, 0); 

2034 if(pte == 0) 

2035 panic ( "clearpteu") ; 

2036 *pte &= ~PTE_U; 

2037 } 
2038 
2039 
2040 
2041 
2042 
2043 
2044 
2045 
2046 
2047 
2048 
2049 



2050 // Given a parent process's page table, create a copy 

2051 // of it for a child. 

2052 pde_t* 

2053 copyuvm (pde_t *pgdir, uint sz) 

2054 { 

2055 pde_t *d; 

2056 pte_t *pte; 

2057 uint pa, i, flags; 

2058 char *mem; 
2059 

2060 if((d = setupkvmO) == 0) 

2061 return 0; 

2062 for(i = 0; i < sz; i += PGSIZE) { 

2063 if ((pte = walkpgdir (pgdir, (void *) i, 0)) == 0) 

2064 panic ("copyuvm: pte should exist"); 

2065 if (! (*pte S PTE_P)) 

2066 panic ("copyuvm: page not present"); 

2067 pa = PTE_ADDR(*pte) ; 

2068 flags = PTE_FLAGS (*pte) ; 

2069 if ((mem = kallocO) == 0) 

2070 goto bad; 

2071 memmove(mem, (char*) p2v (pa) , PGSIZE); 

2072 if (mappages (d, (void*)i, PGSIZE, v2p(mem), flags) < 0) 

2073 goto bad; 

2074 } 

2075 return d; 
2076 

2077 bad: 

2078 freevm (d); 

2079 return 0; 

2080 ) 
2081 
2082 
2083 
2084 
2085 
2086 
2087 
2088 
2089 
2090 
2091 
2092 
2093 
2094 
2095 
2096 
2097 
2098 
2099 
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2100 // Map user virtual address to kernel address. 

2101 char* 

2102 uva2ka(pde_t *pgdir, char *uva) 

2103 { 

2104 pte_t *pte; 
2105 

2106 pte = walkpgdir (pgdir, uva, 0); 

2107 if((*pte S PTE_P) == 0) 

2108 return 0; 

2109 if ( (*pte S PTE_U) == 0) 

2110 return 0; 

2111 return (char*)p2v(PTE_ADDR(*pte) ) ; 

2112 } 
2113 

2114 // Copy len bytes from p to user address va in page table pgdir 

2115 // Most useful when pgdir is not the current page table. 

2116 // uva2ka ensures this only works for PTE_U pages. 

2117 int 

2118 copyout (pde_t *pgdir, uint va, void *p, uint len) 

2119 ( 

2120 char *buf, *paO; 

2121 uint n, vaO; 
2122 

2123 buf = (char*)p; 

2124 while (len > 0) { 

2125 vaO = (uint)PGROUNDDOWN(va) ; 

2126 paO = uva2ka (pgdir, (char*)vaO); 

2127 if(paO == 0) 

2128 return -1; 

2129 n = PGSIZE - (va - vaO) ; 

2130 if(n > len) 

2131 n = len; 

2132 memmove(paO + (va - vaO), buf, n) ; 

2133 len -= n; 

2134 buf += n; 

2135 va = vaO + PGSIZE; 

2136 } 

2137 return 0; 

2138 } 
2139 
2140 
2141 
2142 
2143 
2144 
2145 
2146 
2147 
2148 
2149 
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2300 // Segments in proc->gdt. 

2301 tdefine NSEGS 7 
2302 

2303 // Per-CPU state 

2304 struct cpu { 

2305 uchar id; // Local APIC ID; index into cpus[] below 

2306 struct context *scheduler; // swtchO here to enter scheduler 

2307 struct taskstate ts; // Used by x86 to find stack for interrupt 

2308 struct segdesc gdt [NSEGS]; // x86 global descriptor table 

2309 volatile uint started; // Has the CPU started? 

2310 int noli; // Depth of pushcli nesting. 

2311 int intend; // Were interrupts enabled before pushcli? 
2312 

2313 // Cpu-local storage variables; see below 

2314 struct cpu *cpu; 

2315 struct proc *proc; // The currently-running process. 

2316 }; 
2317 

2318 extern struct cpu cpus[NCPU]; 

2319 extern int ncpu; 
2320 

2321 // Per-CPU variables, holding pointers to the 

2322 // current cpu and to the current process. 

2323 // The asm suffix tells gcc to use "%gs:0" to refer to cpu 

2324 // and "%gs:4" to refer to proc. seginit sets up the 

2325 // %gs segment register so that %gs refers to the memory 

2326 // holding those two variables in the local cpu's struct cpu. 

2327 // This is similar to how thread-local variables are implemented 

2328 // in thread libraries such as Linux pthreads. 

2329 extern struct cpu *cpu asm( "%gs : 0" ) ; // Scpus [cpunumO ] 

2330 extern struct proc *proc asm("%gs : 4") ; // cpus [cpunumO ] .proc 
2331 

2332 

2333 // Saved registers for kernel context switches. 

2334 // Don't need to save all the segment registers (%cs, etc), 

2335 // because they are constant across kernel contexts. 

2336 // Don't need to save %eax, %ecx, %edx, because the 

2337 // x86 convention is that the caller has saved them. 

2338 // Contexts are stored at the bottom of the stack they 

2339 // describe; the stack pointer is the address of the context. 

2340 // The layout of the context matches the layout of the stack in swtch.S 

2341 // at the "Switch stacks" comment. Switch doesn't save eip explicitly, 

2342 // but it is on the stack and allocprocO manipulates it. 

2343 struct context { 

2344 uint edi; 

2345 uint esi; 
234 6 uint ebx; 

2347 uint ebp; 

2348 uint eip; 

2349 }; 
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2350 enum procstate { UNUSED, EMBRYO, SLEEPING, RUNNABLE, RUNNING, ZOMBIE }; 
2351 



2352 


// Per-process state 






2353 


struct proc { 






2354 


uint sz; 


// 


Size of process memory (bytes) 


2355 


pde_t* pgdir; 


// 


Page table 


2356 


char *kstack; 


// 


Bottom of kernel stack for this process 


2357 


enum procstate state; 


// 


Process state 


2358 


int pid; 


// 


Process ID 


2359 


struct proc *parent; 


// 


Parent process 


2360 


struct trapframe *tf; 


// 


Trap frame for current syscall 


2361 


struct context *context; 


// 


swtchO here to run process 


2362 


void *chan; 


// 


If non-zero, sleeping on chan 


2363 


int killed; 


// 


If non-zero, have been killed 


2364 


struct file *of lie [NOFILE] ; 


// 


Open files 


2365 


struct inode *cwd; 


// 


Current directory 


2366 


char name [16] ; 


// 


Process name (debugging) 



2367 ); 
2368 

2369 // Process memory is laid out contiguously, low addresses first: 

2370 // text 

2371 // original data and bss 

2372 // fixed-size stack 

2373 // expandable heap 
2374 

2375 
2376 
2377 
2378 
2379 
2380 
2381 
2382 
2383 
2384 
2385 
2386 
2387 
2388 
2389 
2390 
2391 
2392 
2393 
2394 
2395 
2396 
2397 
2398 
2399 
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2400 #include "types. h" 


2450 


// Look in the process table for an UNUSED proc. 


2401 #include "defs.h" 


2451 


// If found, change state to EMBRYO and initialize 


2402 tinclude "param.h" 


2452 


// state required to run in the kernel. 


2403 tinclude "memlayout .h" 


2453 


// Otherwise return 0. 


2404 tinclude "mmu.h" 


2454 


static struct proc* 


2405 tinclude "x86.h" 


2455 


allocproc (void) 


2406 tinclude "proc.h" 


2456 


{ 


2407 tinclude "spinlock.h" 


2457 


struct proc *p; 


2408 


2458 


char *sp; 


2409 struct { 


2459 




2410 struct spinlock lock; 


2460 


acquire (Sptable . lock) ; 


2411 struct proc proc[NPROC] ; 


2461 


for(p = ptable. proc; p < Sptable .proc [NPROC] ; p++) 


2412 } ptable; 


2462 


if (p->state == UNUSED) 


2413 


2463 


goto found; 


2414 static struct proc *initproc; 


2464 


release (Sptable. lock) ; 


2415 


2465 


return 0; 


2416 int nextpid = 1; 


2466 




2417 extern void f orkret (void) ; 


2467 


found: 


2418 extern void trapret (void) ; 


2468 


p->state = EMBRYO; 


2419 


2469 


p->pid = nextpid++; 


2420 static void wakeupl (void *chan) ; 


2470 


release (Sptable . lock) ; 


2421 


2471 




2422 void 


2472 


// Allocate kernel stack. 


2423 pinit(void) 


2473 


if ( (p->kstack = kallocO) == 0) { 


2424 { 


2474 


p->state = UNUSED; 


2425 initlock(Sptable.lock, "ptable"); 


2475 


return 0; 


2426 } 


2476 


} 


2427 


2477 


sp = p->kstack + KSTACKSIZE; 


2428 


2478 




2429 


2479 


// Leave room for trap frame. 


2430 


2480 


sp -= sizeof *p->tf; 


2431 


2481 


p->tf = (struct trapf rarae*) sp; 


2432 


2482 




2433 


2483 


// Set up new context to start executing at f orkret 


2434 


2484 


// which returns to trapret. 


2435 


2485 


sp -= 4; 


2436 


2486 


*(uint*)sp = (uint) trapret; 


2437 


2487 




2438 


2488 


sp -= sizeof *p->context; 


2439 


2489 


p->context = (struct context*) sp; 


2440 


2490 


raemset (p->context, 0, sizeof *p->context) ; 


2441 


2491 


p->context->eip = (uint) f orkret; 


2442 


2492 




2443 


2493 


return p; 


2444 


2494 


} 


2445 


2495 




2446 


2496 




2447 


2497 




2448 


2498 




2449 


2499 
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2500 // Set up first user process. 

2501 void 

2502 userinit (void) 

2503 { 

2504 struct proc *p; 

2505 extern char _binary_initcode_start [ ] , _binary_initcode_size [ ] ; 
2506 

2507 p = allocprocO; 

2508 initproc = p; 

2509 if((p->pgdir = setupkvmO) == 0) 

2510 panic ( "userinit : out of memory?"); 

2511 inituvm (p->pgdir, _binary_initcode_start, (int)_binary_initcode_siz 

2512 p->sz = PGSIZE; 

2513 memset (p->tf , 0, sizeof (*p->tf ) ) ; 

2514 p->tf->cs = (SEGJCODE « 3) I DPLJSER; 

2515 p->tf->ds = (SEGJDATA « 3) | DPLJSER; 

2516 p->tf->es = p->tf->ds; 

2517 p->tf->ss = p->tf->ds; 

2518 p->tf->eflags = FL_IF; 

2519 p->tf->esp = PGSIZE; 

2520 p->tf->eip = 0; // beginning of initcode.S 
2521 

2522 safestrcpy (p->narae, "initcode", sizeof (p->narae) ) ; 

2523 p->cwd = naraei ("/") ; 
2524 

2525 p->state = RUNNABLE; 

2526 } 
2527 

2528 // Grow current process's memory by n bytes. 

2529 // Return 0 on success, -1 on failure. 

2530 int 

2531 growproc(int n) 

2532 { 

2533 uint sz; 
2534 

2535 sz = proc->sz; 

2536 if (n > 0) { 

2537 if((sz = allocuvm(proc->pgdir, sz, sz + n) ) == 0) 

2538 return -1; 

2539 } else if (n < 0) { 

2540 if((sz = deallocuvm(proc->pgdir, sz, sz + n) ) == 0) 

2541 return -1; 

2542 } 

2543 proc->sz = sz; 

2544 switchuvm(proc) ; 

2545 return 0; 

2546 } 
2547 
2548 
2549 
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2550 // Create a new process copying p as the parent. 

2551 // Sets up stack to return as if from system call. 

2552 // Caller must set state of returned proc to RUNNABLE. 

2553 int 

2554 fork (void) 

2555 { 

2556 int i, pid; 

2557 struct proc *np; 
2558 

2559 // Allocate process. 

2560 if((np = allocprocO) == 0) 

2551 return -1; 
2562 

2563 // Copy process state from p. 

2564 if ( (np->pgdir = copyuvm(proc->pgdir, proc->sz)) == 0) { 

2565 kf ree (np->kstack) ; 

2566 np->kstack = 0; 

2567 np->state = UNUSED; 

2568 return -1; 

2569 } 

2570 np->sz = proc->sz; 

2571 np->parent = proc; 

2572 *np->tf = *proc->tf; 
2573 

2574 // Clear %eax so that fork returns 0 in the child. 

2575 np->tf->eax = 0; 
2576 

2577 for(i = 0; i < NOFILE; i++) 

2578 if (proc->ofile[i] ) 

2579 np->ofile[i] = f iledup (proc->of ile [i] ) ; 

2580 np->cwd = idup (proc->cwd) ; 
2581 

2582 safestrcpy (np->name, proc->name, sizeof (proc->name) ) ; 

2583 

2584 pid = np->pid; 

2585 

2586 // lock to force the compiler to emit the np->state write last. 

2587 acquire (Sptable . lock) ; 

2588 np->state = RUNNABLE; 

2589 release (Sptable. lock) ; 
2590 

2591 return pid; 

2592 } 
2593 
2594 
2595 
2596 
2597 
2598 
2599 
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2600 // Exit the current process. Does not return. 
2501 // An exited process remains in the zombie state 

2602 // until its parent calls wait() to find out it exited. 

2603 void 

2604 exit (void) 

2605 { 

2606 struct proc *p; 

2607 int fd; 
2608 

2609 if (proc == initproc) 

2610 panic ("init exiting"); 

2611 

2612 // Close all open files. 

2613 for(fd = 0; fd < NOFILE; fd++) { 

2614 if (proc->ofile[fd] ) { 

2615 f ileclose (proc->of ile [fd] ) ; 

2616 proc->ofile[fd] = 0; 

2617 } 

2618 } 
2619 

2 620 begin_op () ; 

2621 iput (proc->cwd) ; 

2622 end_op(); 

2623 proc->cwd = 0; 
2624 

2625 acquire (Sptable .lock) ; 
2626 

2627 // Parent might be sleeping in wait(). 

2628 wakeupl (proc->parent) ; 
2629 

2630 // Pass abandoned children to init. 

2631 for(p = ptable.proc; p < Sptable. proc [NPROC] ; p++) { 

2632 if(p->parent == proc) { 

2633 p->parent = initproc; 

2634 if(p->state == ZOMBIE) 

2635 wakeupl (initproc) ; 

2636 } 

2637 } 
2638 

2639 // Jump into the scheduler, never to return. 

2640 proc->state = ZOMBIE; 

2641 schedO; 

2642 panic ("zombie exit"); 

2643 } 
2644 
2645 
2646 
2647 
2648 
2649 
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2650 // Wait for a child process to exit and return its pid. 

2651 // Return -1 if this process has no children. 

2652 int 

2653 wait (void) 

2654 { 

2655 struct proc *p; 

2656 int havekids, pid; 
2657 

2658 acquire (Sptable. lock) ; 

2659 for(;;){ 



2660 // Scan through table looking for zombie children. 

2661 havekids = 0; 

2662 for(p = ptable.proc; p < Sptable. proc[NPROC] ; p++) { 

2663 if (p->parent != proc) 

2664 continue; 

2665 havekids = 1; 

2666 if(p->state == ZOMBIE) { 

2667 // Found one. 

2668 pid = p->pid; 

2669 kfree{p->kstack); 

2670 p->kstack = 0; 

2671 freevm (p->pgdir) ; 

2672 p->state = UNUSED; 

2673 p->pid = 0; 

2674 p->parent = 0; 

2675 p->name[0] = 0; 

2676 p->killed = 0; 

2677 release (Sptable. lock) ; 

2678 return pid; 

2679 } 

2680 } 
2681 

2682 // No point waiting if we don't have any children. 

2683 if(!havekids I I proc->killed) { 

2684 release (Sptable. lock) ; 

2685 return -1; 

2686 } 
2687 

2688 // Wait for children to exit. (See wakeupl call in proc_exit. 

2689 sleep(proc, Sptable. lock) ; 



2690 } 

2691 } 
2692 
2693 
2694 
2695 
2696 
2697 
2698 
2699 
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2700 // Per-CPU process scheduler. 

2701 // Each CPU calls scheduler () after setting itself up. 

2702 // Scheduler never returns. It loops, doing: 



2703 // - choose a process to run 

2704 // - swtch to start running that process 

2705 // - eventually that process transfers control 

2706 // via swtch back to the scheduler. 



2707 void 

2708 scheduler (void) 

2709 { 

2710 struct proc *p; 

2711 

2712 for(;;){ 



2713 // Enable interrupts on this processor. 

2714 sti(); 
2715 

2716 // Loop over process table looking for process to run. 

2717 acquire (Sptable . lock) ; 

2718 for(p = ptable.proc; p < Sptable. proc [NPROC] ; p++) { 

2719 if(p->state != RUNNABLE) 

2720 continue; 
2721 

2722 // Switch to chosen process. It is the process's job 

2723 //to release ptable.lock and then reacquire it 

2724 // before jumping back to us. 

2725 proc = p; 

2726 switchuvm(p) ; 

2727 p->state = RUNNING; 

2728 swtch (Scpu->scheduler, proc->context) ; 

2729 switchkvmO ; 

2730 

2731 // Process is done running for now. 

2732 // It should have changed its p->state before coming back. 

2733 proc = 0; 

2734 } 

2735 release (Sptable. lock) ; 

2736 



2737 } 

2738 } 
2739 
2740 
2741 
2742 
2743 
2744 
2745 
2746 
2747 
2748 
2749 
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2750 // Enter scheduler. Must hold only ptable.lock 

2751 // and have changed proc->state. 

2752 void 

2753 sched(void) 

2754 { 

2755 int intena; 
2756 

2757 if (!holding(Sptable.lock) ) 

2758 panicC'sched ptable.lock"); 

2759 if(cpu->ncll != 1) 

2760 panic ("sched locks") ; 

2761 if (proc->state == RUNNING) 

2762 panic ("sched running"); 

2763 if (readeflags()SFL_IF) 

2764 panic ("sched interruptible") ; 

2765 intena = cpu->intena; 

2766 swtch (Sproc->context, cpu->scheduler) ; 

2767 cpu->intena = intena; 

2768 ) 
2769 

2770 // Give up the CPU for one scheduling round. 

2771 void 

2772 yield(void) 

2773 { 

2774 acquire (Sptable. lock) ; 

2775 proc->state = RUNNABLE; 

2776 schedO; 

2777 release (Sptable. lock) ; 

2778 ) 
2779 

2780 // A fork child's very first scheduling by scheduler () 

2781 // will swtch here. "Return" to user space. 

2782 void 

2783 f orkret (void) 

2784 { 

2785 static int first = 1; 

2786 // Still holding ptable.lock from scheduler. 

2787 release (Sptable. lock) ; 

2788 

2789 if (first) { 

2790 // Some initialization functions must be run in the context 

2791 // of a regular process (e.g., they call sleep), and thus cannot 

2792 // be run from main(). 

2793 first = 0; 

2794 initlogO; 

2795 } 
2796 

2797 // Return to "caller", actually trapret (see allocproc) . 

2798 ) 
2799 
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2800 // Atomically release lock and sleep on chan. 

2801 // Reacquires lock when awakened. 

2802 void 

2803 sleep (void *chan, struct spinlock *lk) 

2804 { 

2805 if(proc == 0) 

2806 panic ("sleep") ; 
2807 

2808 if (Ik == 0) 

2809 panic ("sleep without Ik"); 

2810 

2811 // Must acquire ptable.lock in order to 

2812 // change p->state and then call sched. 

2813 // Once we hold ptable.lock, we can be 

2814 // guaranteed that we won't miss any wakeup 

2815 // (wakeup runs with ptable.lock locked), 

2816 // so it's okay to release Ik. 

2817 if (Ik != Sptable.lock) { 

2818 acquire (Sptable.lock) ; 

2819 release (Ik); 

2820 } 
2821 

2822 // Go to sleep. 

2823 proc->chan = chan; 

2824 proc->state = SLEEPING; 

2825 schedO; 
2826 

2827 // Tidy up. 

2828 proc->chan = 0; 

2829 

2830 // Reacquire original lock. 

2831 if (Ik != Sptable.lock)! 

2832 release (Sptable . lock) ; 

2833 acquire (Ik); 

2834 } 

2835 } 
2836 
2837 
2838 
2839 
2840 
2841 
2842 
2843 
2844 
2845 
2846 
2847 
2848 
2849 



2850 // Wake up all processes sleeping on chan. 

2851 // The ptable lock must be held. 

2852 static void 

2853 wakeupl (void *chan) 

2854 { 

2855 struct proc *p; 
2856 

2857 for(p = ptable. proc; p < iptable.proc[NPROC] ; p++) 

2858 if (p->state == SLEEPING SS p->chan == chan) 

2859 p->state = RUNNABLE; 

2860 ) 
2861 

2862 // Wake up all processes sleeping on chan. 

2863 void 

2864 wakeup (void *chan) 

2865 { 

2866 acquire (Sptable . lock) ; 

2867 wakeupl (chan) ; 

2868 release (Sptable. lock) ; 

2869 } 
2870 

2871 // Kill the process with the given pid. 

2872 // Process won't exit until it returns 

2873 // to user space (see trap in trap.c) . 

2874 int 

2875 kill (int pid) 

2876 { 

2877 struct proc *p; 
2878 

2879 acquire (Sptable . lock) ; 

2880 for(p = ptable. proc; p < Sptable .proc [NPROC] ; p++) { 

2881 if (p->pid == pid) { 

2882 p->killed = 1; 

2883 // Wake process from sleep if necessary. 

2884 if(p->state == SLEEPING) 

2885 p->state = RUNNABLE; 

2886 release (Sptable.lock) ; 

2887 return 0; 

2888 } 

2889 } 

2890 release (Sptable. lock) ; 

2891 return -1; 

2892 } 
2893 
2894 
2895 
2896 
2897 
2898 
2899 
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2900 // Print a process listing to console. For debugging. 

2901 // Runs when user types ^P on console. 

2902 //No lock to avoid wedging a stuck machine further. 

2903 void 

2904 procdump (void) 

2905 { 

2906 static char *states[] = { 

2907 [UNUSED] "unused", 

2908 [EMBRYO] "embryo", 

2909 [SLEEPING] "sleep ", 

2910 [RUNNABLE] "runble", 

2911 [RUNNING] "run 

2 912 [ZOMBIE] "zombie" 

2913 }; 

2914 int i; 

2915 struct proc *p; 

2916 char *state; 

2917 uint pc [10] ; 
2918 

2919 for(p = ptable.proc; p < Sptable.proc [NPROC] ; p++) { 

2920 if (p->state == UNUSED) 

2921 continue; 

2922 if(p->state >= 0 && p->state < NELEM(states) S& states [p->state] ) 

2923 state = states [p->state] ; 

2924 else 

2925 state = "???"; 

2926 cprintf("%d %s %s", p->pid, state, p->name) ; 

2927 if (p->state == SLEEPING) ( 

2928 getcallerpcs ( (uint*)p->context->ebp+2, pc) ; 

2929 for(i=0; KIO && pc[i] != 0; i++) 

2930 cprintf (" %p", pc[i]); 

2931 1 

2932 cprintf ("\n") ; 

2933 } 

2934 } 
2935 
2936 
2937 
2938 
2939 
2940 
2941 
2942 
2943 
2944 
2945 
2946 
2947 
2948 
2949 
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2950 # Context switch 

2951 # 

2952 # void swtch (struct context **old, struct context *new) ; 

2953 # 

2954 # Save current register context in old 

2955 # and then load register context from new. 
2956 

2957 .globl swtch 

2958 swtch: 

2959 movl 4{%esp), %eax 

2960 movl 8(%esp), %edx 

2961 

2962 # Save old callee-save registers 

2963 pushl %ebp 

2964 pushl %ebx 

2965 pushl %esi 

2966 pushl %edi 
2967 

2968 # Switch stacks 

2969 movl %esp, (%eax) 

2970 movl %edx, %esp 
2971 

2972 # Load new callee-save registers 

2973 popl %edi 

2974 popl %esi 

2975 popl %ebx 

2976 popl %ebp 

2977 ret 
2978 

2979 
2980 
2981 
2982 
2983 
2984 
2985 
2986 
2987 
2988 
2989 
2990 
2991 
2992 
2993 
2994 
2995 
2996 
2997 
2998 
2999 
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3000 // Physical memory allocator, intended to allocate 

3001 // memory for user processes, kernel stacks, page table pages, 

3002 // and pipe buffers. Allocates 4096-byte pages. 
3003 

3004 tinclude "types. h" 

3005 tinclude "defs.h" 

3006 tinclude "param.h" 

3007 tinclude "memlayout .h" 

3008 tinclude "mmu.h" 

3009 tinclude "spinlock.h" 
3010 

3011 void f reerange (void *vstart, void *vend) ; 

3012 extern char end[]; // first address after kernel loaded from ELF file 

3013 

3014 struct run { 

3015 struct run *next; 

3016 }; 
3017 

3018 struct ( 

3019 struct spinlock lock; 

3020 int use_lock; 

3021 struct run *freelist; 

3022 } kraem; 
3023 

3024 // Initialization happens in two phases. 

3025 // 1. mainO calls kinitlO while still using entrypgdir to place just 

3026 // the pages mapped by entrypgdir on free list. 

3027 // 2. mainO calls kinit2() with the rest of the physical pages 

3028 // after installing a full page table that maps them on all cores. 

3029 void 

3030 kinitl(void *vstart, void *vend) 

3031 { 

3032 initlock (Skmem. lock, "kmem"); 

3033 kmem.use_lock = 0; 

3034 f reerange (vstart, vend) ; 

3035 } 
3036 

3037 void 

3038 kinit2 (void *vstart, void *vend) 

3039 { 

3040 f reerange (vstart, vend); 

3041 kmem.use_lock = 1; 

3042 } 
3043 
3044 
3045 
3046 
3047 
3048 
3049 
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3050 void 

3051 f reerange (void *vstart, void *vend) 

3052 { 

3053 char *p; 

3054 p = (char*) PGROUNDUP ( (uint) vstart); 

3055 for(; p + PGSIZE <= (char*) vend; p += PGSIZE) 

3056 kfree(p); 

3057 } 
3058 
3059 

3060 // Free the page of physical memory pointed at by v, 

3061 // which normally should have been returned by a 

3062 // call to kallocO. (The exception is when 

3063 // initializing the allocator; see kinit above.) 

3064 void 

3065 kfree(char *v) 

3066 { 

3067 struct run *r; 
3068 

3069 if ( (uint) V % PGSIZE |1 v < end 1| v2p(v) >= PHYSTOP) 

3070 panic ("kfree"); 
3071 

3072 // Fill with junk to catch dangling refs. 

3073 memset(v, 1, PGSIZE); 
3074 

3075 if (kmem.use_lock) 

3076 acquire (Skmem. lock) ; 

3077 r = (struct run*)v; 

3078 r->next = kmem. f reelist; 

3079 kmem. f reelist = r; 

3080 if (kmem.use_lock) 

3081 release (Skmem. lock) ; 

3082 ) 
3083 

3084 // Allocate one 4096-byte page of physical memory. 

3085 // Returns a pointer that the kernel can use. 

3086 // Returns 0 if the memory cannot be allocated. 

3087 char* 

3088 kalloc(void) 

3089 { 

3090 struct run *r; 
3091 

3092 if (kmem.use_lock) 

3093 acquire (Skmem. lock) ; 

3094 r = kmem. freelist; 

3095 if(r) 

3096 kmem. freelist = r->next; 

3097 if (kmem.use_lock) 

3098 release (Skmem. lock) ; 

3099 return (char*)r; 
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3100 } 

3101 

3102 

3103 

3104 

3105 

3106 

3107 

3108 

3109 

3110 

3111 

3112 

3113 

3114 

3115 

3116 

3117 

3118 

3119 

3120 

3121 

3122 

3123 

3124 

3125 

3126 

3127 

3128 

3129 

3130 

3131 

3132 

3133 

3134 

3135 

3136 

3137 

3138 

3139 

3140 

3141 

3142 

3143 

3144 

3145 

3146 

3147 

3148 

3149 
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3150 


// x85 trap and interrupt constants. 


3151 








3152 


// Processor-defined: 






3153 


♦define T_DIVIDE 


0 


// divide error 


3154 


♦define T_DEBUG 


1 


// debug exception 


3155 


♦define T_NMI 


2 


// non-maskable interrupt 


3156 


♦define T_BRKPT 


3 


// breakpoint 


3157 


♦define T_OFLOW 


4 


// overflow 


3158 


♦define T_BOUND 


5 


// bounds check 


3159 


♦define T_ILLOP 


6 


// illegal opcode 


3160 


♦define T_DEVICE 


7 


// device not available 


3161 


♦define T_DBLFLT 


8 


// double fault 


3162 


// Idefine T_COPROC 


9 


// reserved (not used since 486) 


3163 


♦define T_TSS 


10 


// invalid task switch segment 


3164 


♦define T_SEGNP 


11 


// segment not present 


3165 


♦define T_STACK 


12 


// stack exception 


3166 


♦define T_GPFLT 


13 


// general protection fault 


3167 


♦define T_PGFLT 


14 


// page fault 


3168 


// ♦define T_RES 


15 


// reserved 


3169 


♦define T_FPERR 


16 


// floating point error 


3170 


♦define T_ALIGN 


17 


// aligment check 


3171 


♦define T_MCHK 


18 


// machine check 


3172 


♦define T_SIMDERR 


19 


// SIMD floating point error 


3173 








3174 


// These are arbitrarily chosen, 


• but with care not to overlap 


3175 


// processor defined exceptions 


or interrupt vectors. 


3176 


♦define T_SYSCALL 


64 


// system call 


3177 


♦define T_DEFAULT 


500 


// catchall 


3178 








3179 


♦define T_IRQO 


32 


// IRQ 0 corresponds to int T_IRQ 


3180 








3181 


♦define IRQ_TIMER 


0 




3182 


♦define IRQ_KBD 


1 




3183 


♦define IRQ_C0M1 


4 




3184 


♦define IRQ_IDE 


14 




3185 


♦define IRQ_ERROR 


19 




3186 


♦define IRQ_SPURIOUS 


31 




3187 








3188 








3189 








3190 








3191 








3192 








3193 








3194 








3195 








3196 








3197 








3198 








3199 
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3200 #!/usr/bin/perl -w 
3201 

3202 t Generate vectors. S, the trap/interrupt entry points. 

3203 # There has to be one entry point per interrupt number 

3204 # since otherwise there's no way for trapO to discover 

3205 # the interrupt number. 
3206 

3207 print "# generated by vectors.pl - do not edit\n"; 

3208 print "# handlers\n"; 

3209 print ".globl alltraps\n"; 

3210 for(my $1 = 0; $1 < 256; $i++) { 

3211 print ".globl vector$i\n"; 

3212 print "vector$i : \n"; 

3213 if(!($i == 8 I I ($i >= 10 SS $i <= 14) || $i == 17) ){ 

3214 print " pushl \$0\n"; 

3215 ) 

3216 print " pushl \$$l\n"; 

3217 print " jmp alltraps\n"; 

3218 } 
3219 

3220 print "\n# vector table\n"; 

3221 print ".data\n"; 

3222 print ".globl vectors\n"; 

3223 print "vectors :\n"; 

3224 for (my $i = 0; $i < 256; $i++) { 

3225 print " .long vector$i\n"; 

3226 } 
3227 

3228 # sample output: 

3229 # # handlers 

3230 # .globl alltraps 

3231 # .globl vectorO 

3232 # vectorO: 

3233 # pushl $0 

3234 # pushl $0 

3235 # jmp alltraps 

3236 # 

3237 # 

3238 # # vector table 

3239 # .data 

3240 # .globl vectors 

3241 # vectors: 

3242 # .long vectorO 

3243 # .long vectorl 

3244 # .long vector2 

3245 # 
3246 
3247 
3248 
3249 



3250 tinclude "mmu.h" 
3251 

3252 # vectors. S sends all traps here. 

3253 .globl alltraps 

3254 alltraps: 

3255 # Build trap frame. 

3256 pushl %ds 

3257 pushl %es 

3258 pushl %fs 

3259 pushl %gs 

3260 pushal 
3261 

3262 # Set up data and per-cpu segments. 

3263 movw $ (SEG_KDATA«3) , %ax 

3264 movw %ax, %ds 

3265 movw %ax, %es 

3266 movw $ (SEG_KCPU«3) , %ax 

3267 movw %ax, %fs 

3268 movw %ax, %gs 
3269 

3270 # Call trap(tf), where tf=%esp 

3271 pushl %esp 

3272 call trap 

3273 addl $4, %esp 
3274 

3275 # Return falls through to trapret... 

3276 .globl trapret 

3277 trapret: 

3278 popal 

3279 popl %gs 

3280 popl %fs 

3281 popl %es 

3282 popl %ds 

3283 addl $0x8, %esp # trapno and errcode 

3284 iret 
3285 

3286 
3287 
3288 
3289 
3290 
3291 
3292 
3293 
3294 
3295 
3296 
3297 
3298 
3299 
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3300 #include "types. h" 

3301 #include "defs.h" 

3302 tinclude "param.h" 

3303 tinclude "memlayout .h" 

3304 tinclude "mmu.h" 

3305 tinclude "proc.h" 

3306 tinclude "x86.h" 

3307 tinclude "traps. h" 

3308 tinclude "spinlock.h" 
3309 

3310 // Interrupt descriptor table (shared by all CPUs) . 

3311 struct gatedesc idt[256]; 

3312 extern uint vectors []; //in vectors. S: array of 256 entry pointers 

3313 struct spinlock tickslock; 

3314 uint ticks; 
3315 

3316 void 

3317 tvinit (void) 

3318 { 

3319 int i; 
3320 

3321 for(i = 0; i < 256; i++) 

3322 SETGATE(idt[i], 0, SEG_KC0DE«3, vectors [i], 0); 

3323 SETGATE(idt[T_SYSCALL], 1, SEG_KC0DE«3, vectors [T_SYSCALL] , DPL_USER) ; 
3324 

3325 initlock (Stickslock, "time"); 

3326 } 
3327 

3328 void 

3329 idtinit(void) 

3330 { 

3331 lidt(idt, sizeof (idt) ) ; 

3332 } 
3333 
3334 
3335 
3336 
3337 
3338 
3339 
3340 
3341 
3342 
3343 
3344 
3345 
3346 
3347 
3348 
3349 
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3350 void 

3351 trap (struct trapframe *tf) 

3352 { 

3353 if (tf->trapno == T_SYSCALL) { 

3354 if (proc->killed) 

3355 exitO; 

3356 proc->tf = tf; 

3357 syscallO; 

3358 if (proc->killed) 

3359 exitO; 

3360 return; 

3361 } 
3362 

3363 switch (tf->trapno) { 

3364 case T_IRQO + IRQ_TIMER: 

3365 if (cpu->id == 0) { 

3366 acquire (Stickslock) ; 

3367 ticks++; 

3368 wakeup (Sticks) ; 

3369 release (Stickslock) ; 

3370 } 

3371 lapiceoiO; 

3372 break; 

3373 case T_IRQO + IRQ_IDE: 

3374 ideintrO; 

3375 lapiceoiO; 

3376 break; 

3377 case T_IRQO + IRQ_IDE+1: 

3378 // Boohs generates spurious IDEl interrupt 

3379 break; 

3380 case T_IRQO + IRQ_KBD: 

3381 kbdintrO; 

3382 lapiceoiO; 

3383 break; 

3384 case T_IRQO + IRQ_C0M1 : 

3385 uartintrO; 

3386 lapiceoiO; 

3387 break; 

3388 case T_IRQO + 7: 

3389 case T_IRQO + IRQ_SPURIOUS : 

3390 cprintf ("cpu%d: spurious interrupt at %x:% 

3391 cpu->id, tf->cs, tf->eip) ; 

3392 lapiceoiO; 

3393 break; 
3394 

3395 
3396 
3397 
3398 
3399 
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3400 default: 

3401 if(proc == 0 I I (tf->csS3) == 0){ 

3402 // In kernel, it must be our mistake. 

3403 cprintf ("unexpected trap %d from cpu %d eip %x (cr2=0x%x) \n", 

3404 tf->trapno, cpu->id, tf->eip, rcr2()); 

3405 panic ("trap"); 

3406 } 

3407 //In user space, assume process misbehaved. 

3408 cprintf ("pid %d %s: trap %d err %d on cpu %d " 

3409 "eip Ox%x addr 0x%x— kill proc\n", 

3410 proc->pid, proc->name, tf->trapno, tf->err, cpu->id, tf->eip, 

3411 rcr2()); 

3412 proc->killed = 1; 

3413 ) 
3414 

3415 // Force process exit if it has been killed and is in user space. 

3416 // (If it is still executing in the kernel, let it keep running 

3417 // until it gets to the regular system call return.) 

3418 if (proc && proc->killed && (tf->csS3) == DPL_USER) 

3419 exitO; 
3420 

3421 // Force process to give up CPU on clock tick. 

3422 //If interrupts were on while locks held, would need to check nlock. 

3423 if (proc && proc->state == RUNNING S& tf->trapno == T_IRQO+IRQ_TIMER) 

3424 yieldO; 
3425 

3426 // Check if the process has been killed since we yielded 

3427 if (proc && proc->killed && (tf->csS3) == DPL_USER) 

3428 exitO; 



3429 } 

3430 

3431 

3432 

3433 

3434 

3435 

3436 

3437 

3438 

3439 

3440 

3441 

3442 

3443 

3444 

3445 

3446 

3447 

3448 

3449 
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3450 


// System call numbers 


3451 


#def ine 


SYS_ 


_fork 


1 


3452 


#def ine 


SYS. 


.exit 


2 


3453 


#def ine 


SYS. 


.wait 


3 


3454 


♦define 


SYSjipe 


4 


3455 


♦define 


SYS. 


.read 


5 


3456 


♦define 


SYS. 


.kill 


6 


3457 


♦define 


SYS. 


.exec 


7 


3458 


♦define 


SYS. 


.f Stat 


8 


3459 


♦define 


SYS. 


.chdir 


9 


3460 


fdef ine 


SYS_ 


_dup 


10 


3461 


fdef ine 


SYS_ 


_getpid 


11 


3462 


♦define 


SYS_ 


_sbrk 


12 


3463 


fdef ine 


SYS_ 


_sleep 


13 


3464 


fdef ine 


SYS_ 


_uptime 


14 


3465 


fdef ine 


SYS_ 


_open 


15 


3466 


fdef ine 


SYS_ 


_write 


16 


3467 


♦define 


SYS_ 


_mknod 


17 


3468 


♦define 


SYS_ 


_unlink 


18 


3469 


♦define 


SYS_ 


_link 


19 


3470 


♦define 


SYS_ 


_mkdir 


20 


3471 


♦define 


SYS. 


.close 


21 



3472 
3473 
3474 
3475 
3476 
3477 
3478 
3479 
3480 
3481 
3482 
3483 
3484 
3485 
3486 
3487 
3488 
3489 
3490 
3491 
3492 
3493 
3494 
3495 
3496 
3497 
3498 
3499 
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3500 #include "types. h" 

3501 #include "defs.h" 

3502 tinclude "param.h" 

3503 tinclude "memlayout .h" 

3504 tinclude "mmu.h" 

3505 tinclude "proc.h" 

3506 tinclude "x86.h" 

3507 tinclude "syscall.h" 
3508 

3509 // User code makes a system call with INT T_SYSCALL. 

3510 // System call number in %eax. 

3511 // Arguments on the stack, from the user call to the C 

3512 // library system call function. The saved user %esp points 

3513 // to a saved program counter, and then the first argument. 
3514 

3515 // Fetch the int at addr from the current process. 

3516 int 

3517 fetchint (uint addr, int *ip) 

3518 ( 

3519 if (addr >= proc->sz || addr+4 > proc->sz) 

3520 return -1; 

3521 *ip = * (int*) (addr) ; 

3522 return 0; 

3523 } 
3524 

3525 // Fetch the nul-terminated string at addr from the current process. 

3526 // Doesn't actually copy the string - just sets *pp to point at it. 

3527 // Returns length of string, not including nul. 

3528 int 

352 9 fetchstr (uint addr, char **pp) 

3530 { 

3531 char *s, *ep; 

3532 

3533 if (addr >= proc->sz) 

3534 return -1; 

3535 *pp = (char*) addr; 

3536 ep = (char*)proc->sz; 

3537 for(s = *pp; s < ep; s++) 

3538 if(*s == 0) 

3539 return s - *pp; 

3540 return -1; 

3541 } 
3542 

3543 // Fetch the nth 32-bit system call argument. 

3544 int 

3545 argint(int n, int *ip) 

3546 { 

3547 return fetchint (proc->tf->esp + 4 + 4*n, ip) ; 

3548 } 
3549 
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3550 // Fetch the nth word-sized system call argument as a pointer 

3551 // to a block of memory of size n bytes. Check that the pointer 

3552 // lies within the process address space. 

3553 int 

3554 argptr(int n, char **pp, int size) 

3555 { 

3556 int i; 
3557 

3558 if(argint(n, Si) < 0) 

3559 return -1; 

3560 if ( (uint) i >= proc->sz || (uint)i+size > proc->sz) 

3561 return -1; 

3562 *pp = (char*)i; 

3563 return 0; 

3564 ) 
3565 

3566 // Fetch the nth word-sized system call argument as a string pointer. 

3567 // Check that the pointer is valid and the string is nul-terminated. 

3568 // (There is no shared writable memory, so the string can't change 

3569 // between this check and being used by the kernel.) 

3570 int 

3571 argstr(int n, char **pp) 

3572 { 

3573 int addr; 

3574 if(argint(n, Saddr) < 0) 

3575 return -1; 

3576 return fetchstr (addr, pp) ; 

3577 } 
3578 

3579 extern int sys_chdir (void) ; 

3580 extern int sys_close (void) ; 

3581 extern int sys_dup (void) ; 

3582 extern int sys_exec (void) ; 

3583 extern int sys_exit (void) ; 

3584 extern int sys_f ork (void) ; 

3585 extern int sys_fstat (void) ; 

3586 extern int sys_getpid (void) ; 

3587 extern int sys_kill (void) ; 

3588 extern int sys_link (void) ; 

3589 extern int sys_mkdir (void) ; 

3590 extern int sys_mknod(void) ; 

3591 extern int sys_open (void) ; 

3592 extern int sys_pipe (void) ; 

3593 extern int sys_read(void) ; 

3594 extern int sys_sbrk (void) ; 

3595 extern int sys_sleep (void) ; 

3596 extern int sys_unlink (void) ; 

3597 extern int sys_wait (void) ; 

3598 extern int sys_write (void) ; 

3599 extern int sys_uptime (void) ; 
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3600 static int (*syscalls [] ) (void) = { 



3601 


[SYS_ 


_fork] 


sys. 


.fork, 


3602 


[SYS. 


.exit] 


sys. 


.exit, 


3603 


[SYS. 


.wait] 


sys. 


.wait. 


3604 


[SYS_pipe] 


sysjipe, 


3605 


[SYS. 


.read] 


sys. 


.read. 


3606 


[SYS. 


.kill] 


sys. 


.kill. 


3607 


[SYS. 


.exec] 


sys. 


.exec, 


3608 


[SYS. 


.fstat] 


sys 


_f Stat, 


3609 


[SYS. 


.chdir] 


sys. 


_chdir, 


3610 


[SYS_ 


_dupl 


sys_ 


_dup, 


3611 


[SYS_ 


_getpid] 


sys_ 


_getpid, 


3612 


[SYS_ 


_sbrk] 


sys_ 


_sbrk, 


3613 


[SYS_ 


_sleep] 


sys_ 


_sleep, 


3614 


[SYS_ 


_uptime] 


sys_ 


_upt ime , 


3615 


[SYS_ 


_open] 


sys_ 


_open, 


3616 


[SYS_ 


_write] 


sys_ 


_write, 


3617 


[SYS_ 


_mknod] 


sys_ 


_mknod, 


3618 


[SYS_ 


_unlink] 


sys_ 


_unlink, 


3619 


[SYS_ 


_link] 


sys_ 


_link, 


3620 


[SYS_ 


_mkdir] 


sys_ 


_mkdir, 


3621 


[SYS. 


.close] 


sys. 


.close, 



3622 }; 
3623 

3624 void 

3625 syscall (void) 

3626 ( 

3627 int nura; 
3628 

3629 num = proc->tf->eax; 

3630 if (num > 0 S& num < NELEM (syscalls) S& syscalls [num] ) ( 

3631 proc->tf->eax = syscalls [num] () ; 

3632 } else { 

3633 cprintf("%d %s: unknown sys call %d\n", 

3634 proc->pid, proc->name, num) ; 

3635 proc->tf->eax = -1; 

3636 } 

3637 } 
3638 
3639 
3640 
3641 
3642 
3643 
3644 
3645 
3646 
3647 
3648 



3650 tinclude "types. h" 

3651 tinclude "x86.h" 

3652 #include "defs.h" 

3653 #include "param.h" 

3654 #include "memlayout .h" 

3655 #include "mmu.h" 

3656 #include "proc.h" 
3657 

3658 int 

3659 sys_f ork (void) 

3660 ( 

3651 return fork () ; 

3662 ) 

3663 

3664 int 

3665 sys_exit (void) 

3666 { 

3667 exitO; 

3668 return 0; // not reached 

3669 ) 
3670 

3671 int 

3672 sys_wait (void) 

3673 { 

3674 return wait () ; 

3675 } 
3676 

3677 int 

3678 sys_kill(void) 

3679 ( 

3680 int pid; 
3681 

3682 if(argint(0, Spid) < 0) 

3683 return -1; 

3684 return kill (pid) ; 

3685 ) 
3686 

3687 int 

3688 sys_getpid(void) 

3689 { 

3690 return proc->pid; 

3691 } 
3692 
3693 
3694 
3695 
3696 
3697 
3698 
3699 
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3700 int 

3701 SYS_sbrk (void) 

3702 { 

3703 int addr; 

3704 int n; 
3705 

3706 if(argint(0, &n) < 0) 

3707 return -1; 

3708 addr = proc->sz; 

3709 if (growproc(n) < 0) 

3710 return -1; 

3711 return addr; 

3712 } 
3713 

3714 int 

3715 SYS_sleep (void) 

3716 ( 

3717 int n; 

3718 uint ticksO; 

3719 

3720 if(argint(0, Sn) < 0) 

3721 return -1; 

3722 acquire (Stickslock) ; 

3723 ticksO = ticks; 

3724 while (ticks - ticksO < n) { 

3725 if (proc->killed) { 

3726 release (Stickslock) ; 

3727 return -1; 

3728 } 

3729 sleep (Sticks, Stickslock); 

3730 } 

3731 release (Stickslock) ; 

3732 return 0; 

3733 } 
3734 

3735 // return how many clock tick interrupts have occurred 

3736 // since start. 

3737 int 

3738 sys_uptime (void) 

3739 { 

3740 uint xticks; 
3741 

3742 acquire (Stickslock) ; 

3743 xticks = ticks; 

3744 release (Stickslock) ; 

3745 return xticks; 

3746 } 
3747 
3748 
3749 
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3750 struct buf { 

3751 int flags; 

3752 uint dev; 

3753 uint sector; 

3754 struct buf *prev; // LRU cache list 

3755 struct buf *next; 

3756 struct buf *qnext; // disk queue 

3757 uchar data[512] ; 

3758 }; 

3759 #define B_BUSY 0x1 // buffer is locked by some process 

3760 tdefine B_VALID 0x2 // buffer has been read from disk 

3761 #define B_DIRTY 0x4 // buffer needs to be written to disk 
3762 

3763 
3764 
3765 
3766 
3767 
3768 
3769 
3770 
3771 
3772 
3773 
3774 
3775 
3776 
3777 
3778 
3779 
3780 
3781 
3782 
3783 
3784 
3785 
3786 
3787 
3788 
3789 
3790 
3791 
3792 
3793 
3794 
3795 
3796 
3797 
3798 
3799 
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3800 
3801 
3802 
3803 
3804 
3805 
3806 
3807 
3808 
3809 
3810 
3811 
3812 
3813 
3814 
3815 
3816 
3817 
3818 
3819 
3820 
3821 
3822 
3823 
3824 
3825 
3826 
3827 
3828 
3829 
3830 
3831 
3832 
3833 
3834 
3835 
3836 
3837 
3838 
3839 
3840 
3841 
3842 
3843 
3844 
3845 
3846 
3847 



♦define 0_RDONLY 0x000 

♦define 0_WRONLY 0x001 

♦define 0_RDWR 0x002 

♦define 0_CREATE 0x200 



3849 



3850 
3851 
3852 
3853 
3854 
3855 
3856 
3857 
3858 
3859 
3860 
3861 
3862 
3863 



♦define T_DIR 1 // Directory 
♦define T_FILE 2 // File 
♦define T_DEV 3 // Device 



struct Stat { 
short type; 
int dev; 
uint ino; 
short nlink; 
uint size; 



3865 
3866 
3867 



3869 
3870 
3871 
3872 
3873 
3874 
3875 
3876 
3877 
3878 
3879 
3880 
3881 
3882 
3883 
3884 
3885 
3886 
3887 



3889 
3890 
3891 
3892 
3893 
3894 
3895 
3896 
3897 



// Type of file 

// File system's disk device 

// Inode number 

// Number of links to file 

// Size of file in bytes 



3899 
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3900 // On-disk file system format. 

3901 // Both the kernel and user programs use this header file. 
3902 

3903 // Block 0 is unused. 

3904 // Block 1 is super block. 

3905 // Blocks 2 through sb.ninodes/IPB hold inodes. 

3906 // Then free bitmap blocks holding sb.size bits. 

3907 // Then sb.nblocks data blocks. 

3908 // Then sb.nlog log blocks. 

3909 

3910 #define ROOTINO 1 // root i-number 

3911 #define BSIZE 512 // block size 
3912 

3913 // File system super block 

3914 struct superblock { 

3915 uint size; // Size of file system image (blocks) 

3916 uint nblocks; // Number of data blocks 

3917 uint ninodes; // Number of inodes. 

3918 uint nlog; // Number of log blocks 

3919 }; 
3920 

3921 idefine NDIRECT 12 

3922 tdefine NINDIRECT (BSIZE / sizeof (uint) ) 

3923 tdefine MAXFILE (NDIRECT + NINDIRECT) 
3924 

3925 // On-disk inode structure 

3926 struct dinode { 



3927 


short type; 


// 


File type 


3928 


short major; 


// 


Major device number (T_DEV only) 


3929 


short minor; 


// 


Minor device number (T_DEV only) 


3930 


short nlink; 


// 


Number of links to inode in file system 


3931 


uint size; 


// 


Size of file (bytes) 


3932 


uint addrs[NDIRECT+l] 




// Data block addresses 



3933 }; 
3934 

3935 // Inodes per block. 

3936 #define IPB (BSIZE / sizeof (struct dinode)) 
3937 

3938 // Block containing inode i 

3939 tdefine IBLOCK(i) ( (i) / IPB + 2) 
3940 

3941 // Bitmap bits per block 

3942 tdefine BPB (BSIZE*8) 
3943 

3944 // Block containing bit for block b 

3945 tdefine BBLOCK(b, ninodes) (b/BPB + (ninodes) /IPB + 3) 
3946 

3947 // Directory is a file containing a sequence of dirent structures. 

3948 tdefine DIRSIZ 14 
3949 
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3950 struct dirent { 

3951 ushort inum; 

3952 char name [DIRSIZ] ; 

3953 }; 
3954 
3955 
3956 
3957 
3958 
3959 
3960 
3961 
3962 
3963 
3964 
3965 
3966 
3967 
3968 
3969 
3970 
3971 
3972 
3973 
3974 
3975 
3976 
3977 
3978 
3979 
3980 
3981 
3982 
3983 
3984 
3985 
3986 
3987 
3988 
3989 
3990 
3991 
3992 
3993 
3994 
3995 
3996 
3997 
3998 
3999 
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4000 struct file { 4050 // Blank page. 

4001 enum { FD_NONE, FD_PIPE, FD_INODE } type; 4051 

4002 int ref; // reference count 4052 

4003 char readable; 4053 

4004 char writable; 4054 

4005 struct pipe *pipe; 4055 

4006 struct inode *ip; 4056 

4007 uint off; 4057 

4008 }; 4058 

4009 4059 

4010 4060 

4011 // in-memory copy of an inode 4061 

4012 struct inode { 4062 

4013 uint dev; // Device number 4063 

4014 uint inum; // Inode number 4064 

4015 int ref; // Reference count 4065 

4016 int flags; // I_BUSY, I_VALID 4066 

4017 4067 

4018 short type; // copy of disk inode 4068 

4019 short major; 4069 

4020 short minor; 4070 

4021 short nlink; 4071 

4022 uint size; 4072 

4023 uint addrs[NDIRECT+l] ; 4073 

4024 }; 4074 

4025 tdefine I_BUSY 0x1 4075 

4026 tdefine I_VALID 0x2 4076 

4027 4077 

4028 // table mapping major device number to 4078 

4029 // device functions 4079 

4030 struct devsw { 4080 

4031 int (*read) (struct inode*, char*, int); 4081 

4032 int (*write) (struct inode*, char*, int); 4082 

4033 }; 4083 

4034 4084 

4035 extern struct devsw devsw[]; 4085 

4036 4086 

4037 tdefine CONSOLE 1 4087 

4038 4088 

4039 4089 

4040 4090 

4041 4091 

4042 4092 

4043 4093 

4044 4094 

4045 4095 

4046 4096 

4047 4097 

4048 4098 

4049 4099 
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4100 // Simple PlO-based (non-DMA) IDE driver code. 

4101 

4102 tinclude 

4103 tinclude 

4104 tinclude 

4105 tinclude 

4106 tinclude 

4107 tinclude 

4108 tinclude 

4109 tinclude 

4110 #include 

4111 #include 
4112 

4113 tdefine 1DE_BSY 0x80 

4114 tdefine 1DE_DRDY 0x40 

4115 tdefine 1DE_DF 0x20 

4116 tdefine IDE_ERR 0x01 
4117 

4118 tdefine IDE_CMD_READ 0x20 

4119 tdefine 1DE_CMD_WR1 TE 0x30 
4120 

4121 // idequeue points to the buf now being read/written to the disk. 

4122 // idequeue->qnext points to the next buf to be processed. 

4123 // You must hold idelock while manipulating queue. 
4124 

4125 static struct spinlock idelock; 

4126 static struct buf *idequeue; 
4127 

4128 static int havediskl; 

4129 static void idestart (struct buf *) ; 

4130 

4131 // Wait for IDE disk to become ready. 

4132 static int 

4133 idewait(int checkerr) 

4134 { 

4135 int r; 
4136 

4137 while(((r = inb(0xlf7)) S (IDE_BSY | IDE_DRDY) ) !=IDE_DRDY) 

4138 ; 

4139 if (checkerr SS (r S (IDE_DF | IDE_ERR) ) != 0) 

4140 return -1; 

4141 return 0; 

4142 } 
4143 
4144 
4145 
4146 
4147 
4148 
4149 
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4150 void 

4151 ideinit (void) 

4152 { 

4153 int i; 
4154 

4155 initlock(&idelock, "ide"); 

4156 picenable(IRQ_IDE); 

4157 ioapicenable (IRQ_IDE, ncpu - 1); 

4158 idewait(O); 
4159 

4160 // Check if disk 1 is present 

4161 outb(0xlf6, OxeO I (1«4)); 

4162 for(i=0; KIOOO; i++) { 

4163 if (inb(0xlf7) != 0) { 

4164 havediskl = 1; 

4165 break; 

4166 } 

4167 ) 
4168 

4169 // Switch back to disk 0. 

4170 outb(0xlf6, OxeO | (0«4)); 

4171 } 
4172 

4173 // Start the request for b. Caller must hold idelock. 

4174 static void 

4175 idestart (struct buf *b) 

4176 { 

4177 if (b == 0) 

4178 panic ("idestart"); 

4179 

4180 idewait(O); 

4181 outb(0x3f6, 0); // generate interrupt 

4182 outb(0xlf2, 1); // number of sectors 

4183 outb(0xlf3, b->sector S Oxff ) ; 

4184 outb(0xlf4, (b->sector » 8) S Oxff); 

4185 outb(0xlf5, (b->sector » 16) S Oxff); 

4186 outb(0xlf6, OxeO I ( (b->devSl) «4) | ( (b->sector»24) SOxOf ) ) ; 

4187 if(b->flags S B_DIRTY) { 

4188 outb(0xlf7, IDE_CMD_WRITE) ; 

4189 outsl(OxlfO, b->data, 512/4); 

4190 } else { 

4191 OUtb(0xlf7, IDE_CMD_READ) ; 

4192 } 

4193 } 
4194 
4195 
4196 
4197 
4198 
4199 



Sheet 41 



Aug 29 17:09 2014 xv6/ide.c Page 3 



Aug 29 17:09 2014 xv6/ide.c Page 4 



4200 // Interrupt handler. 4250 

4201 void 4251 

4202 ideintr(void) 4252 

4203 { 4253 

4204 struct buf *b; 4254 

4205 4255 

4206 // First queued buffer is the active request. 4256 

4207 acquire (Sidelock); 4257 

4208 if((b = idequeue) == 0) { 4258 

4209 release (Sidelock) ; 4259 

4210 // cprintf ("spurious IDE interrupt\n") ; 4260 

4211 return; 4261 

4212 } 4262 

4213 idequeue = b->qnext; 4263 

4214 4264 

4215 // Read data if needed. 4265 

4216 if (! (b->flags & B_DIRTY) SS idewait(l) >= 0) 4266 

4217 insKOxlfO, b->data, 512/4); 4267 

4218 4268 

4219 // Wake process waiting for this buf. 4269 

4220 b->flags |= B_VALID; 4270 

4221 b->flags S= ~B_DIRTY; 4271 

4222 wakeup(b); 4272 

4223 4273 

4224 // Start disk on next buf in queue. 4274 

4225 if (idequeue != 0) 4275 

4226 idestart (idequeue) ; 4276 

4227 4277 

4228 release (Sidelock) ; 4278 

4229 } 4279 

4230 4280 

4231 4281 

4232 4282 

4233 4283 

4234 4284 

4235 4285 

4236 4286 

4237 4287 

4238 4288 

4239 4289 

4240 4290 

4241 4291 

4242 4292 

4243 4293 

4244 4294 

4245 4295 

4246 4296 

4247 4297 

4248 4298 

4249 4299 



// Sync buf with disk. 

// If B_DIRTY is set, write buf to disk, clear B_DIRTY, set B_VALID. 
// Else if B_VALID is not set, read buf from disk, set B_VALID. 
void 

iderw (struct buf *b) 
{ 

struct buf **pp; 

if (! (b->flags S B_BUSY) ) 

panic ("iderw: buf not busy"); 

if((b->flags & (B_VALID | B_DIRTY) ) == B_VALID) 

panic ("iderw: nothing to do"); 
if(b->dev != 0 && Ihavediskl) 

panic ("iderw: ide disk 1 not present"); 

acquire (Sidelock) ; 

// Append b to idequeue. 
b->qnext = 0; 

f or (pp=Sidequeue; *pp; pp=S (*pp) ->qnext) 
*pp = b; 

// Start disk if necessary, 
if (idequeue == b) 
idestart (b) ; 

// Wait for request to finish. 

while ( (b->f lags S (B_VALID | B_DIRTY) ) !=B_VALID){ 
sleep (b, Sidelock); 

} 

release (Sidelock) ; 

) 
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4300 // Buffer cache. 

4301 // 

4302 // The buffer cache is a linked list of buf structures holding 

4303 // cached copies of disk block contents. Caching disk blocks 

4304 //in memory reduces the number of disk reads and also provides 

4305 //a synchronization point for disk blocks used by multiple processes 

4306 // 

4307 // Interface: 

4308 // * To get a buffer for a particular disk block, call bread. 

4309 // * After changing buffer data, call bwrite to write it to disk. 

4310 // * When done with the buffer, call brelse. 

4311 // * Do not use the buffer after calling brelse. 

4312 // * Only one process at a time can use a buffer, 

4313 // so do not keep them longer than necessary. 

4314 // 

4315 // The implementation uses three state flags internally: 

4316 // * B_BUSY: the block has been returned from bread 

4317 // and has not been passed back to brelse. 

4318 // * B_VALID: the buffer data has been read from the disk. 

4319 // * B_DIRTY: the buffer data has been modified 

4320 // and needs to be written to disk. 
4321 

4322 finclude "types. h" 

4323 finclude "defs.h" 

4324 finclude "param.h" 

4325 finclude "spinlock.h" 

4326 finclude "buf.h" 
4327 

4328 struct { 

4329 struct spinlock lock; 

4330 struct buf buf [NBUF] ; 
4331 

4332 // Linked list of all buffers, through prev/next. 

4333 // head. next is most recently used. 

4334 struct buf head; 

4335 } bcache; 
4336 

4337 void 

4338 binit(void) 

4339 { 

4340 struct buf *b; 
4341 

4342 initlock(&bcache.lock, "bcache"); 

4343 

4344 

4345 

4346 

4347 

4348 

4349 
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4350 // Create linked list of buffers 

4351 bcache . head. prev = Sbcache .head; 

4352 bcache. head. next = Sbcache.head; 

4353 for(b = bcache. buf; b < bcache .buf +NBUF; b++) { 

4354 b->next = bcache. head. next; 

4355 b->prev = sbcache.head; 

4356 b->dev = -1; 

4357 bcache. head. next->prev = b; 

4358 bcache. head. next = b; 

4359 } 



4360 ) 
4361 

4362 // Look through buffer cache for sector on device dev. 

4363 // If not found, allocate a buffer. 

4364 // In either case, return B_BUSY buffer. 

4365 static struct buf* 

4366 bget(uint dev, uint sector) 

4367 { 

4368 struct buf *b; 

4369 

4370 acquire (Sbcache. lock) ; 
4371 

4372 loop: 



4373 // Is the sector already cached? 

4374 for(b = bcache. head. next; b != Sbcache.head; b = b->next) { 

4375 if(b->dev == dev ss b->sector == sector) { 

4376 if (! (b->flags S B_BUSY) ) { 

4377 b->flags |= B_BUSY; 

4378 release (Sbcache. lock) ; 

4379 return b; 

4380 } 

4381 sleep(b, Sbcache. lock) ; 

4382 goto loop; 

4383 } 

4384 } 
4385 

4386 // Not cached; recycle some non-busy and clean buffer. 

4387 // "clean" because B_DIRTY and !B_BUSY means log.c 

4388 // hasn't yet committed the changes to the buffer. 

4389 for(b = bcache. head. prev; b != Sbcache.head; b = b->prev) { 

4390 if((b->flags S B_BUSY) == 0 SS (b->flags S B_DIRTY) == 0) 

4391 b->dev = dev; 

4392 b->sector = sector; 

4393 b->flags = B_BUSY; 

4394 release (Sbcache. lock) ; 

4395 return b; 

4396 } 

4397 } 

4398 panic("bget: no buffers"); 



4399 ) 
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4400 // Return a B_BUSY buf with the contents of the indicated disk sector. 

4401 struct buf* 

4402 bread (uint dev, uint sector) 

4403 { 

4404 struct buf *b; 
4405 

4406 b = bget (dev, sector); 

4407 if (! (b->flags & B_VALID) ) 

4408 iderw(b); 

4409 return b; 

4410 } 
4411 

4412 // Write b's contents to disk. Must be B_BUSY. 

4413 void 

4414 bwrite (struct buf *b) 

4415 { 

4416 if((b->flags & B_BUSY) == 0) 

4417 panic ( "bwrite" ) ; 

4418 b->flags |= B_DIRTY; 

4419 iderw(b); 

4420 } 
4421 

4422 // Release a B_BUSY buffer. 

4423 // Move to the head of the MRU list. 

4424 void 

4425 brelse (struct buf *b) 



4426 ■ 


( 


4427 


if((b->flags S B_BUSY) == 0) 


4428 


panic ("brelse") ; 


4429 




4430 


acquire (Sbcache . lock) ; 


4431 




4432 


b->next->prev = b->prev; 


4433 


b->prev->next = b->next; 


4434 


b->next = bcache. head. next; 


4435 


b->prev = Sbcache. head; 


4436 


bcache. head. next->prev = b; 


4437 


bcache. head. next = b; 


4438 




4439 


b->flags &= ~B_BUSY; 


4440 


wakeup (b) ; 


4441 




4442 


release (Sbcache .lock) ; 


4443 ; 


\ 


4444 




4445 




4446 




4447 




4448 




4449 
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4450 // Blank page. 

4451 
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4495 

4496 

4497 
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4500 #include "types. h" 

4501 #include "defs.h" 

4502 tinclude "param.h" 

4503 tinclude "spinlock.h" 

4504 tinclude "fs.h" 

4505 tinclude "buf.h" 
4506 

4507 // Simple logging that allows concurrent FS system calls. 

4508 // 

4509 //A log transaction contains the updates of multiple FS system 

4510 // calls. The logging system only commits when there are 

4511 // no FS system calls active. Thus there is never 

4512 // any reasoning required about whether a commit might 

4513 // write an uncommitted system call's updates to disk. 

4514 // 

4515 // A system call should call begin_op () /end_op ( ) to mark 

4516 // its start and end. Usually begin_op() just increments 

4517 // the count of in-progress FS system calls and returns. 

4518 // But if it thinks the log is close to running out, it 

4519 // sleeps until the last outstanding end_op() commits. 

4520 // 

4521 // The log is a physical re-do log containing disk blocks. 

4522 // The on-disk log format: 

4523 // header block, containing sector #s for block A, B, C, ... 

4524 // block A 

4525 // block B 

4526 // block C 

4527 // 

4528 // Log appends are synchronous. 

4529 

4530 // Contents of the header block, used for both the on-disk heade 

4531 // and to keep track in memory of logged sector ts before commit 

4532 struct logheader { 

4533 int n; 

4534 int sector [LOGSIZE] ; 

4535 }; 
4536 

4537 struct log { 

4538 struct spinlock lock; 

4539 int start; 

4540 int size; 

4541 int outstanding; // how many FS sys calls are executing. 

4542 int committing; // in commit (), please wait. 

4543 int dev; 

4544 struct logheader Ih; 

4545 }; 
4546 
4547 
4548 
4549 
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4550 struct log log; 
4551 

4552 static void recover_f rom_log (void) ; 

4553 static void commit (); 
4554 

4555 void 

4556 initlog (void) 

4557 { 

4558 if (sizeof (struct logheader) >= BSIZE) 

4559 panic ("initlog: too big logheader"); 

4560 

4561 struct superblock sb; 

4562 initlock(Slog.lock, "log"); 

4563 readsb(ROOTDEV, &sb) ; 

4564 log. start = sb.size - sb.nlog; 

4565 log. size = sb.nlog; 

4566 log. dev = ROOTDEV; 

4567 recover_from_log() ; 

4568 ) 
4569 

4570 // Copy committed blocks from log to their home location 

4571 static void 

4572 install_trans (void) 

4573 { 

4574 int tail; 
4575 

4576 for (tail = 0; tail < log.lh.n; tail++) { 

4577 struct buf *lbuf = bread (log. dev, log. start +tail+l) ; // read log block 

4578 struct buf *dbuf = bread(log.dev, log. Ih. sector [tail] ) ; // read dst 

4579 memmove (dbuf->data, lbuf->data, BSIZE); // copy block to dst 

4580 bwrite(dbuf); // write dst to disk 

4581 brelse(lbuf) ; 

4582 brelse(dbuf) ; 

4583 } 

4584 } 
4585 

4586 // Read the log header from disk into the in-memory log header 

4587 static void 

4588 read_head (void) 

4589 { 

4590 struct buf *buf = bread(log.dev, log. start); 

4591 struct logheader *lh = (struct logheader *) (buf->data) ; 

4592 int i; 

4593 log.lh.n = lh->n; 

4594 for (i = 0; i < log.lh.n; i++) { 

4595 log. Ih. sector [i] = lh->sector [i] ; 

4596 } 

4597 brelse(buf); 

4598 } 
4599 
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4 600 // Write in-memory log header to disk. 

4601 // This is the true point at which the 

4602 // current transaction commits. 

4603 static void 

4604 write_head(void) 

4605 { 



4606 struct buf *buf = bread (log. dev, log. start); 

4607 struct logheader *hb = (struct logheader *) (buf->data) ; 

4608 int i; 

4609 hb->n = log.lh.n; 

4610 for (i = 0; i < log.lh.n; i++) { 

4611 hb->sector [i] = log. Ih. sector [i] ; 

4612 ) 

4613 bwrite(buf); 

4614 brelse(buf); 



4615 } 
4616 

4617 static void 

4 618 recover_f rom_log (void) 

4619 { 

4 620 read_head{); 

4621 install_trans 0 ; // if committed, copy from log to disk 

4622 log.lh.n = 0; 

4623 write_head() ; // clear the log 

4624 } 
4625 

4626 // called at the start of each FS system call. 

4627 void 

4628 begin_op (void) 

4629 { 

4630 acquire (Slog. lock) ; 

4631 whiledX 



4632 if (log. committing) { 

4633 sleep({;log, Slog. lock); 

4634 } else if (log.lh.n + (log.outstanding+1) *MAXOPBLOCKS > LOGSIZE) 

4635 // this op might exhaust log space; wait for commit. 

4636 sleep(Slog, Slog. lock); 

4637 ) else ( 

4638 log. outstanding += 1; 

4639 release (Slog. lock); 

4640 break; 

4641 } 



4642 } 

4643 } 
4644 
4645 
4646 
4647 
4648 
4649 
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4650 // called at the end of each FS system call. 

4651 // commits if this was the last outstanding operation. 

4652 void 

4653 end_op(void) 

4654 { 

4655 int do_commit = 0; 
4656 

4657 acquire (Slog. lock) ; 

4658 log. outstanding -= 1; 

4659 if (log. committing) 

4660 panic ("log. committing") ; 

4661 if (log. outstanding == 0) | 

4662 do_commit = 1; 

4663 log. committing = 1; 

4664 } else ( 

4665 // begin_op() may be waiting for log space. 

4666 wakeup (Slog) ; 

4667 } 

4668 release (Slog. lock) ; 

4669 

4670 if (do_commit) { 

4671 // call commit w/o holding locks, since not allowed 

4672 //to sleep with locks. 

4673 commit 0; 

4674 acquire (Slog. lock) ; 

4675 log. committing = 0; 

4676 wakeup (Slog) ; 

4677 release (Slog. lock) ; 

4678 } 

4679 ) 
4680 

4681 // Copy modified blocks from cache to log. 

4682 static void 

4683 write_log(void) 

4684 { 

4685 int tail; 
4686 

4687 for (tail = 0; tail < log.lh.n; tall++) { 

4688 struct buf *to = bread (log. dev, log. start +tail+l) ; // log block 

4689 struct buf *from = bread (log. dev, log. Ih. sector [tail] ) ; // cache block 

4690 memmove (to->data, from->data, BSIZE) ; 

4691 bwrite(to); // write the log 

4692 brelse (from) ; 

4693 brelse (to); 

4694 } 

4695 } 
4696 
4697 
4698 
4699 
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4700 static void 

4701 commit 0 

4702 { 

4703 if (log.lh.n > 0) { 

4704 write_log(); // Write modified blocks from cache to log 

4705 write_head ( ) ; // Write header to disk — the real commit 

4706 install_trans 0 ; // Now install writes to home locations 

4707 log.lh.n = 0; 

4708 write_head ( ) ; // Erase the transaction from the log 

4709 } 

4710 } 
4711 

4712 // Caller has modified b->data and is done with the buffer. 

4713 // Record the block number and pin in the cache with B_DIRTY. 

4714 // commit 0 /write_log() will do the disk write. 

4715 // 

4716 // log_write() replaces bwriteO; a typical use is: 

4717 // bp = bread(...) 

4718 // modify bp->data[] 

4719 // log_write(bp) 

4720 // brelse(bp) 

4721 void 

4722 log_write (struct buf *b) 

4723 { 

4724 int i; 
4725 

4726 if (log.lh.n >= LOGSIZE || log.lh.n >= log. size - 1) 

4727 panic ("too big a transaction"); 

4728 if (log. outstanding < 1) 

4729 panic ("log_write outside of trans"); 

4730 

4731 for (i = 0; i < log.lh.n; i++) { 

4732 if (log. Ih. sector [i] == b->sector) // log absorbtion 

4733 break; 

4734 ) 

4735 log. Ih. sector [i] = b->sector; 

4736 if (i == log.lh.n) 

4737 log.lh.n++; 

4738 b->flags 1= B_DIRTY; // prevent eviction 

4739 } 
4740 
4741 
4742 
4743 
4744 
4745 
4746 
4747 
4748 
4749 
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4750 // File system implementation. Five layers: 

4751 // + Blocks: allocator for raw disk blocks. 

4752 // + Log: crash recovery for multi-step updates. 

4753 // + Files: inode allocator, reading, writing, metadata. 

4754 // + Directories: inode with special contents (list of other inodes!) 

4755 // + Names: paths like /usr/rtm/xv6/fs.c for convenient naming. 

4756 // 

4757 // This file contains the low-level file system manipulation 

4758 // routines. The (higher-level) system call implementations 

4759 // are in sysfile.c. 

4760 

4761 tinclude "types. h" 

4762 tinclude "defs.h" 

4763 tinclude "param.h" 

4764 tinclude "stat.h" 

4765 tinclude "mmu.h" 

4766 tinclude "proc.h" 

4767 tinclude "spinlock.h" 

4768 tinclude "buf.h" 

4769 tinclude "fs.h" 

4770 tinclude "file.h" 
4771 

4772 tdefine min(a, b) ((a) < (b) ? (a) : (b) ) 

4773 static void itrunc (struct inode*); 
4774 

4775 // Read the super block. 

4776 void 

4777 readsb(int dev, struct superblock *sb) 

4778 { 

4779 struct buf *bp; 

4780 

4781 bp = breadidev, 1) ; 

4782 memmove(sb, bp->data, sizeof (*sb) ) ; 

4783 brelse(bp); 

4784 } 
4785 

4786 // Zero a block. 

4787 static void 

4788 bzero(int dev, int bno) 

4789 { 

4790 struct buf *bp; 
4791 

4792 bp = bread(dev, bno); 

4793 memset (bp->data, 0, BSIZE) ; 

4794 log_write (bp) ; 

4795 brelse(bp); 

4796 } 
4797 
4798 
4799 
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4800 // Blocks. 
4801 

4802 // Allocate a zeroed disk block. 

4803 static uint 

4804 balloc(uint dev) 

4805 { 

4806 int b, bi, ra; 

4807 struct buf *bp; 

4808 struct superblock sb; 
4809 

4810 bp = 0; 

4811 readsb(dev, Ssb) ; 

4812 for(b = 0; b < sb.size; b += BPB) { 



4813 bp = bread (dev, BBLOCK(b, sb.ninodes) ) ; 

4814 for(bi = 0; bi < BPB S& b + bi < sb.size; bi++) { 

4815 m = 1 « (bi % 8) ; 

4816 if ( (bp->data[bi/8] & m) 0) { // Is block free 

4817 bp->data[bi/8] |= m; // Mark block in use. 

4818 log_write (bp) ; 

4819 brelse(bp); 

4820 bzero(dev, b + bi) ; 

4821 return b + bi; 

4822 } 

4823 } 

4824 brelse(bp); 



4825 } 

4826 panic ("bailee: out of blocks"); 

4827 } 
4828 

4829 // Free a disk block. 

4830 static void 

4831 bfree(int dev, uint b) 

4832 { 



4833 struct buf *bp; 

4834 struct superblock sb; 

4835 int bi, m; 
4836 

4837 readsb(dev, ssb); 

4838 bp = bread (dev, BBLOCK(b, sb.ninodes)); 

4839 bi = b % BPB; 

4840 m = 1 « (bi % 8) ; 

4841 if ( (bp->data[bi/8] & ra) == 0) 

4842 panic ("freeing free block"); 

4843 bp->data[bi/8] &= ~m; 

4844 log_write(bp) ; 

4845 brelse(bp); 



4846 } 
4847 
4848 
4849 
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4850 // Inodes. 

4851 // 

4852 // An inode describes a single unnaraed file. 

4853 // The inode disk structure holds raetadata: the file's type, 

4854 // its size, the nuraber of links referring to it, and the 

4855 // list of blocks holding the file's content. 

4856 // 

4857 // The inodes are laid out sequentially on disk imraediately after 

4858 // the superblock. Each inode has a number, indicating its 

4859 // position on the disk. 

4860 // 

4861 // The kernel keeps a cache of in-use inodes in memory 

4862 //to provide a place for synchronizing access 

4863 // to inodes used by multiple processes. The cached 

4864 // inodes include book-keeping information that is 

4865 // not stored on disk: ip->ref and ip->flags. 

4866 // 

4867 //An inode and its in-memory represtative go through a 

4868 // sequence of states before they can be used by the 

4869 // rest of the file system code. 

4870 // 

4871 // * Allocation: an inode is allocated if its type (on disk) 

4872 // is non-zero. iallocO allocates, iputO frees if 

4873 // the link count has fallen to zero. 

4874 // 

4875 // * Referencing in cache: an entry in the inode cache 

4876 // is free if ip->ref is zero. Otherwise ip->ref tracks 

4877 // the number of in-raeraory pointers to the entry (open 

4878 // files and current directories). iget() to find or 

4879 // create a cache entry and increraent its ref, iput() 

4880 // to decrement ref. 

4881 // 

4882 // * Valid: the information (type, size, Sc) in an inode 

4883 // cache entry is only correct when the I_VALID bit 

4884 // is set in ip->flags. ilockO reads the inode from 

4885 // the disk and sets I_VALID, while iput() clears 

4886 // I_VALID if ip->ref has fallen to zero. 

4887 // 

4888 // * Locked: file system code raay only exaraine and modify 

4889 // the inforraation in an inode and its content if it 

4890 // has first locked the inode. The I_BUSY flag indicates 

4891 // that the inode is locked. ilock() sets I_BUSY, 

4892 // while iunlock clears it. 

4893 // 

4894 // Thus a typical sequence is: 

4895 // ip = iget (dev, inum) 

4896 // ilock(ip) 

4897 // ... examine and modify ip->xxx . . . 

4898 // iunlock (ip) 

4899 // iput(ip) 
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4900 // 

4 901 // ilockO is separate from iget() so that system calls can 

4902 // get a long-term reference to an inode (as for an open file) 

4903 // and only lock it for short periods (e.g., in readO). 

4904 // The separation also helps avoid deadlock and races during 

4905 // pathname lookup. iget() increments ip->ref so that the inode 

4906 // stays cached and pointers to it remain valid. 

4907 // 

4908 // Many internal file system functions expect the caller to 

4909 // have locked the inodes involved; this lets callers create 
4 910 // multi-step atomic operations. 

4911 

4912 struct | 

4913 struct spinlock lock; 

4914 struct inode inode [NINODE] ; 

4915 ) icache; 
4916 

4917 void 

4918 iinit(void) 

4919 { 

4920 initlock(Sicache.lock, "icache"); 

4921 } 
4922 

4923 static struct inode* iget(uint dev, uint inum) ; 

4924 

4925 

4926 

4927 

4928 

4929 

4930 

4931 

4932 

4933 

4934 

4935 

4936 

4937 

4938 

4939 

4940 

4941 

4942 

4943 

4944 

4945 

4946 

4947 

4948 

4949 
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4950 // Allocate a new inode with the given type on device dev. 

4951 //A free inode has a type of zero. 

4952 struct inode* 

4953 ialloc(uint dev, short type) 

4954 { 

4955 int inum; 

4956 struct buf *bp; 

4957 struct dinode *dip; 

4958 struct superblock sb; 
4959 

4960 readsb(dev, ssb) ; 

4961 

4962 for(inum = 1; inum < sb.ninodes; inum++) { 

4963 bp = bread (dev, IBLOCK (inum) ) ; 

4964 dip = (struct dinode*)bp->data + inum%IPB; 

4965 if(dip->type == 0) { //a free inode 

4966 memset(dip, 0, sizeof (*dip) ) ; 

4967 dip->type = type; 

4968 log_write (bp) ; // mark it allocated on the disk 

4969 brelse(bp); 

4970 return iget (dev, inum); 

4971 } 

4972 brelse(bp); 

4973 } 

4974 panic ("ialloc: no inodes"); 

4975 } 
4976 

4977 // Copy a modified in-memory inode to disk. 

4978 void 

4979 iupdate (struct inode *ip) 

4980 { 

4981 struct buf *bp; 

4982 struct dinode *dip; 

4983 

4984 bp = bread (ip->dev, IBLOCK (ip->inum) ) ; 

4985 dip = (struct dinode* )bp->data + ip->inum%IPB; 

4986 dip->type = ip->type; 

4987 dip->major = ip->major; 

4988 dip->minor = ip->minor; 

4989 dip->nlink = ip->nlink; 

4990 dip->size = ip->size; 

4991 memmove (dip->addrs, ip->addrs, sizeof (ip->addrs) ) ; 

4992 log_write (bp) ; 

4993 brelse(bp); 

4994 } 
4995 
4996 
4997 
4998 
4999 
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5000 // Find the inode with number inum on device dev 

5001 // and return the in-memory copy. Does not lock 

5002 // the inode and does not read it from disk. 

5003 static struct inode* 

5004 iget (uint dev, uint inum) 

5005 { 

5006 struct inode *ip, *emptY; 
5007 

5008 acquire (Sicache .lock) ; 
5009 

5010 // Is the inode already cached? 

5011 empty = 0; 

5012 for(ip = Sicache. inode [0] ; ip < Sicache . inode [NINODE] ; ip++) 

5013 if(ip->ref > 0 S& ip->dev == dev &S ip->inum == inum) { 

5014 ip->ref++; 

5015 release (Sicache. lock) ; 

5016 return ip; 

5017 } 

5018 if (empty == 0 S& ip->ref == 0) // Remember empty slot. 

5019 empty = ip; 

5020 } 
5021 

5022 // Recycle an inode cache entry. 

5023 if (empty == 0) 

5024 panic ("iget: no inodes"); 
5025 

5026 ip = empty; 

5027 ip->dev = dev; 

5028 ip->inum = inum; 

5029 ip->ref = 1; 

5030 ip->flags = 0; 

5031 release (Sicache .lock) ; 
5032 

5033 return ip; 

5034 } 
5035 

5036 // Increment reference count for ip. 

5037 // Returns ip to enable ip = idup(ipl) idiom. 

5038 struct inode* 

5039 idup (struct inode *ip) 

5040 { 

5041 acquire (Sicache .lock) ; 

5042 ip->ref++; 

5043 release (Sicache .lock) ; 

5044 return ip; 

5045 } 
5046 
5047 
5048 
5049 
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5050 // Lock the given inode. 

5051 // Reads the inode from disk if necessary. 

5052 void 

5053 ilock (struct inode *ip) 

5054 { 

5055 struct buf *bp; 

5056 struct dinode *dip; 
5057 

5058 if (ip == 0 I I ip->ref < 1) 

5059 panic ("ilock") ; 

5060 

5061 acquire (Sicache . lock) ; 

5062 while (ip->flags S 1_BUSY) 

5063 sleep(ip, Sicache . lock) ; 

5064 ip->flags |= I_BUSY; 

5065 release (Sicache . lock) ; 
5066 

5067 if (! (ip->flags S 1_VAL1D)){ 

5068 bp = bread (ip->dev, IBLOCK (ip->inum) ) ; 

5069 dip = (struct dinode*) bp->data + ip->inum%IPB; 

5070 ip->type = dip->type; 

5071 ip->major = dip->major; 

5072 ip->minor = dip->minor; 

5073 ip->nlink = dip->nlink; 

5074 ip->size = dip->size; 

5075 memmove (ip->addrs, dip->addrs, sizeof (ip->addrs) ) ; 

5076 brelse(bp); 

5077 ip->flags |= 1_VAL1D; 

5078 if(ip->type == 0) 

5079 panic ("ilock: no type"); 

5080 ) 

5081 ) 
5082 

5083 // Unlock the given inode. 

5084 void 

5085 iunlock (struct inode *ip) 

5086 { 

5087 if(ip ==011 ! (ip->flags & I_BUSY) || ip->ref < 1) 

5088 panic ("iunlock"); 
5089 

5090 acquire (Sicache. lock) ; 

5091 ip->flags S= ~I_BUSY; 

5092 wakeup(ip); 

5093 release (Sicache. lock) ; 

5094 } 
5095 
5096 
5097 
5098 
5099 
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5100 // Drop a reference to an in-memory inode. 

5101 // If that was the last reference, the inode cache entry can 

5102 // be recycled. 

5103 //If that was the last reference and the inode has no links 

5104 // to it, free the inode (and its content) on disk. 

5105 // All calls to iputO must be inside a transaction in 

5106 // case it has to free the inode. 

5107 void 

5108 iput (struct inode *ip) 

5109 { 

5110 acquire (Sicache . lock) ; 

5111 if(ip->ref == 1 && (ip->flags S I_VALID) && ip->nlink == 0) { 

5112 // inode has no links and no other references: truncate and free. 

5113 if(ip->flags S I_BUSY) 

5114 panicC'iput busy"); 

5115 ip->flags |= I_BUSY; 

5116 release (Sicache. lock) ; 

5117 itrunc (ip) ; 

5118 ip->type = 0; 

5119 iupdate (ip) ; 

5120 acquire (Sicache. lock) ; 

5121 ip->flags = 0; 

5122 wakeup(ip); 

5123 } 

5124 ip->ref— ; 

5125 release (Sicache .lock) ; 

5126 } 

5127 

5128 // Common idiom: unlock, then put. 

5129 void 

5130 iunlockput (struct inode *ip) 

5131 { 

5132 iunlock (ip) ; 

5133 iput(ip); 

5134 } 
5135 
5136 
5137 
5138 
5139 
5140 
5141 
5142 
5143 
5144 
5145 
5146 
5147 
5148 
5149 
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5150 // Inode content 

5151 // 

5152 // The content (data) associated with each inode is stored 

5153 // in blocks on the disk. The first NDIRECT block numbers 

5154 // are listed in ip->addrs[]. The next NINDIRECT blocks are 

5155 // listed in block ip->addrs [NDIRECT] . 
5156 

5157 // Return the disk block address of the nth block in inode ip. 

5158 // If there is no such block, bmap allocates one. 

5159 static uint 

5160 bmap (struct inode *ip, uint bn) 

5161 { 

5162 uint addr, *a; 

5163 struct buf *bp; 
5164 

5165 if (bn < NDIRECT) { 

5166 if ((addr = ip->addrs [bn] ) == 0) 

5167 ip->addrs [bn] = addr = bailee (ip->dev) ; 

5168 return addr; 

5169 } 

5170 bn -= NDIRECT; 
5171 

5172 if (bn < NINDIRECT) { 

5173 // Load indirect block, allocating if necessary. 

5174 if ((addr = ip->addrs [NDIRECT] ) == 0) 

5175 ip->addrs [NDIRECT] = addr = bailee (ip->dev) ; 

5176 bp = bread (ip->dev, addr); 

5177 a = (uint*)bp->data; 

5178 if ( (addr = a[bn] ) == 0) { 

5179 a[bn] = addr = bailee (ip->dev) ; 

5180 log_write (bp) ; 

5181 } 

5182 brelse(bp); 

5183 return addr; 

5184 ) 
5185 

5186 panic ("bmap: out of range"); 

5187 ) 
5188 
5189 
5190 
5191 
5192 
5193 
5194 
5195 
5196 
5197 
5198 
5199 
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5200 // Truncate inode (discard contents) . 

5201 // Only called when the inode has no links 

5202 // to it (no directory entries referring to it) 

5203 // and has no in-memory reference to it (is 

5204 // not an open file or current directory). 

5205 static void 

5206 itrunc (struct inode *ip) 

5207 { 

5208 int i, j; 

5209 struct buf *bp; 

5210 uint *a; 
5211 

5212 for(i = 0; i < NDIRECT; i++) { 

5213 if (ip->addrs[i]) ( 

5214 bf ree (ip->dev, ip->addrs [i] ) ; 

5215 ip->addrs[i] = 0; 

5216 } 

5217 } 
5218 

5219 if (ip->addrs [NDIRECT] ) { 

5220 bp = bread (ip->dev, ip->addrs [NDIRECT] ) ; 

5221 a = (uint*)bp->data; 

5222 for(j = 0; j < NINDIRECT; j++) { 

5223 if(a[j]) 

5224 bfree(ip->dev, a[j]); 

5225 } 

5226 brelse(bp); 

5227 bfree(ip->dev, ip->addrs [NDIRECT] ) ; 

5228 ip->addrs [NDIRECT] = 0; 

5229 } 
5230 

5231 ip->size = 0; 

5232 iupdate (ip) ; 

5233 } 
5234 

5235 // Copy stat information from inode. 

5236 void 

5237 stati (struct inode *ip, struct stat *st) 

5238 { 

5239 st->dev = ip->dev; 

5240 st->ino = ip->inum; 

5241 st->type = ip->type; 

5242 st->nlink = ip->nlink:; 

5243 st->size = ip->size; 

5244 } 
5245 
5246 
5247 
5248 
5249 
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5250 // Read data from inode. 

5251 int 

5252 readi (struct inode *ip, char *dst, uint off, uint n) 

5253 { 

5254 uint tot, ra; 

5255 struct buf *bp; 
5256 

5257 if (ip->type == T_DEV) { 

5258 if(ip->major < 0 jj ip->major >= NDEV jj !devsw[ip->major] .read) 

5259 return -1; 

5260 return devsw[ip->major] .read(ip, dst, n) ; 

5261 ) 
5262 

5263 if (off > ip->size I I off + n < off) 

5264 return -1; 

5265 if(off + n > ip->size) 

5266 n = ip->size - off; 

5267 

5268 for(tot=0; tot<n; tot+=m, off+=m, dst+=m) { 

5269 bp = bread (ip->dev, bmapdp, of f /BSIZE) ) ; 

5270 m = min(n - tot, BSIZE - of f%BSIZE) ; 

5271 meiranove (dst, bp->data + off%BSIZE, m) ; 

5272 brelse(bp); 

5273 } 

5274 return n; 

5275 } 
5276 
5277 
5278 
5279 
5280 
5281 
5282 
5283 
5284 
5285 
5286 
5287 
5288 
5289 
5290 
5291 
5292 
5293 
5294 
5295 
5296 
5297 
5298 
5299 
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5300 // Write data to inode. 

5301 int 

5302 writei (struct inode *ip, char *src, uint off, uint n) 

5303 { 

5304 uint tot, m; 

5305 struct buf *bp; 
5306 

5307 if (ip->tYpe == T_DEV) { 

5308 if(ip->major < 0 || ip->major >= NDEV || !devsw[ip->major] .write) 

5309 return -1; 

5310 return devsw [ip->major] .write (ip, src, n) ; 

5311 } 
5312 

5313 if (off > ip->size I I off + n < off) 

5314 return -1; 

5315 if (off + n > MAXFILE*BSIZE) 

5316 return -1; 
5317 

5318 for(tot=0; tot<n; tot+=m, off+=m, src+=m) ( 

5319 bp = bread (ip->dev, bmap(ip, off /BSIZE) ) ; 

5320 m = min(n - tot, BSIZE - of f%BSIZE) ; 

5321 memmove (bp->data + off%BSIZE, src, m) ; 

5322 log_write(bp) ; 

5323 brelse(bp); 

5324 } 
5325 

5326 if(n > 0 SS off > ip->size) { 

5327 ip->size = off; 

5328 iupdate (ip) ; 

5329 } 

5330 return n; 

5331 } 
5332 
5333 
5334 
5335 
5336 
5337 
5338 
5339 
5340 
5341 
5342 
5343 
5344 
5345 
5346 
5347 
5348 
5349 
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5350 // Directories 

5351 

5352 int 

5353 naraecmp (const char *s, const char *t) 

5354 { 

5355 return strncmp(s, t, DIRSIZ) ; 

5356 } 
5357 

5358 // Look for a directory entry in a directory. 

5359 //If found, set *poff to byte offset of entry. 

5360 struct inode* 

5361 dirlookup (struct inode *dp, char *name, uint *poff) 

5362 ( 



5363 uint off, inum; 

5364 struct dirent de; 

5365 

5366 if(dp->type != T_D1R) 

5367 panic ("dirlookup not DIR"); 

5368 

5369 for (off = 0; off < dp->size; off += sizeof(de)){ 

5370 if(readi(dp, (char*)&de, off, sizeof(de)) != sizeof(de)) 

5371 panic ("dirlink read"); 

5372 if (de. inum == 0) 

5373 continue; 

5374 if (namecmp (name, de.name) == 0) { 

5375 // entry matches path element 

5376 if(poff) 

5377 *poff = off; 

5378 inum = de.inum; 

5379 return iget (dp->dev, inum); 

5380 } 

5381 } 
5382 

5383 return 0; 



5384 ) 

5385 

5386 

5387 

5388 

5389 

5390 

5391 

5392 

5393 

5394 

5395 

5396 

5397 

5398 

5399 
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5400 // Write a new directory entry (name, inum) into the directory dp. 

5401 int 

5402 dirlink (struct inode *dp, char *name, uint inum) 

5403 { 

5404 int off; 

5405 struct dirent de; 

5406 struct inode *ip; 
5407 

5408 // Check that name is not present. 

5409 if((ip = dirlookup(dp, name, 0)) != 0) { 

5410 iput(ip); 

5411 return -1; 

5412 } 
5413 

5414 // Look for an empty dirent. 

5415 for (off = 0; off < dp->size; off += sizeof(de)){ 

5416 if{readi(dp, (char*)&de, off, sizeof(de)) != sizeof(de)) 

5417 panic ( "dirlink read"); 

5418 if (de. inum == 0) 

5419 break; 

5420 } 
5421 

5422 strncpy (de.name, name, DIRSIZ); 

5423 de.inum = inum; 

5424 if (writei (dp, (char*)sde, off, sizeof(de)) != sizeof(de)) 

5425 panic ( "dirlink" ) ; 
5426 

5427 return 0; 

5428 } 

5429 
5430 
5431 
5432 
5433 
5434 
5435 
5436 
5437 
5438 
5439 
5440 
5441 
5442 
5443 
5444 
5445 
5446 
5447 
5448 
5449 
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5450 


// 


Paths 


5451 






5452 


// 


Copy the next path element from path into name. 


5453 


// 


Return a pointer to the element following the copied one 


5454 


// 


The returned path has no leading slashes, 


5455 


// 


so the caller can check *path=='\0' to see if the name i: 


5456 


// 


If no name to remove, return 0. 


5457 


// 




5458 


// 


Examples : 


5459 


// 


skipelem("a/bb/c", name) = "bb/c", setting name = "a" 


5460 


// 


skipelem ( "///a//bb", name) = "bb", setting name = "a" 


5461 


// 


skipelem("a", name) = "", setting name = "a" 


5462 


// 


skipelem("", name) = skipelem("////", name) = 0 


5463 


// 




5464 


static char* 


5465 


skipelem (char *path, char *name) 


5466 


{ 




5467 




char *s; 


5468 




int len; 


5469 






5470 




while (*path == '/') 


5471 




path++; 


5472 




if(*path == 0) 


5473 




return 0; 


5474 




s = path; 


5475 




while (*path != '/' SS *path != 0) 


5476 




path++; 


5477 




len = path - s; 


5478 




if (len >= DIRSIZ) 


5479 




memitiove (name, s, DIRSIZ); 


5480 




else { 


5481 




memmove (name, s, len); 


5482 




name [len] = 0; 


5483 




) 


5484 




while (*path == '/') 


5485 




path++; 


5486 




return path; 


5487 


) 




5488 






5489 






5490 






5491 






5492 






5493 






5494 






5495 






5496 






5497 






5498 






5499 







Sheet 54 



Aug 29 17:09 2014 xv6/fs.c Page 16 



5500 // Look up and return the Inode for a path name. 

5501 // If parent != 0, return the inode for the parent and copy the final 

5502 // path element into name, which must have room for DIRSIZ bytes. 

5503 // Must be called inside a transaction since it calls iput(). 

5504 static struct inode* 

5505 namex(char *path, int nameiparent, char *name) 

5506 { 



5507 struct inode *ip, *next; 
5508 

5509 if(*path == '/') 

5510 ip = iget (ROOTDEV, ROOTINO) ; 

5511 else 

5512 ip = idup (proc->cwd) ; 

5513 

5514 while ((path = slcipelem(path, name)) != 0) { 

5515 ilock (ip) ; 

5516 if(ip->type !=T_DIR){ 

5517 iunlockput (ip) ; 

5518 return 0; 

5519 } 

5520 if (nameiparent S& *path == '\0'){ 

5521 // Stop one level early. 

5522 iunlock (ip) ; 

5523 return ip; 

5524 } 

5525 if ((next = dirlookup (ip, name, 0)) == 0) { 

5526 iunlockput (ip) ; 

5527 return 0; 

5528 } 

5529 iunlockput (ip) ; 

5530 ip = next; 

5531 ) 

5532 if (nameiparent) { 

5533 iput (ip) ; 

5534 return 0; 

5535 } 

5536 return ip; 



5537 } 
5538 

5539 struct inode* 

5540 namei(char *path) 

5541 { 

5542 char name [DIRSIZ] ; 

5543 return namex(path, 0, name); 

5544 } 
5545 
5546 
5547 
5548 
5549 
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5550 struct inode* 

5551 nameiparent (char *path, char *name) 

5552 { 

5553 return namex(path, 1, name); 

5554 } 
5555 
5556 
5557 
5558 
5559 
5560 
5561 
5562 
5563 
5564 
5565 
5566 
5567 
5568 
5569 
5570 
5571 
5572 
5573 
5574 
5575 
5576 
5577 
5578 
5579 
5580 
5581 
5582 
5583 
5584 
5585 
5586 
5587 
5588 
5589 
5590 
5591 
5592 
5593 
5594 
5595 
5596 
5597 
5598 
5599 
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5600 // 

5601 // File descriptors 

5602 // 
5603 

5604 #include "types. h" 

5605 finclude "defs.h" 

5606 finclude "param.h" 

5607 finclude "fs.h" 

5608 finclude "file.h" 

5609 finclude "spinlock.h" 
5610 

5611 struct devsw devsw[NDEVl; 

5612 struct | 

5613 struct spinlook lock; 

5614 struct file file[NFILE]; 

5615 } f table; 
5616 

5617 void 

5618 f ileinit (void) 

5619 { 

5620 initlock(Sftable.lock, "ftable"); 

5621 } 
5622 

5623 // Allocate a file structure. 

5624 struct file* 

5625 filealloc(void) 

5626 { 

5627 struct file *f; 
5628 

5629 acquire (Sftable . lock) ; 

5630 for(f = ftable. file; f < ftable. file + NFILE; f++) | 

5631 if (f->ref == 0) { 

5632 f->ref = 1; 

5633 release (Sftable. lock) ; 

5634 return f; 

5635 } 

5636 } 

5637 release (Sftable. lock) ; 

5638 return 0; 

5639 } 
5640 
5641 
5642 
5643 
5644 
5645 
5646 
5647 
5648 
5649 



5650 // Increment ref count for file f. 

5651 struct file* 

5652 filedup (struct file *f) 

5653 { 

5654 acquire (Sftable. lock) ; 

5655 if(f->ref < 1) 

5656 panicC'filedup") ; 

5657 f->ref++; 

5658 release (Sftable. lock) ; 

5659 return f; 

5660 ) 
5661 

5662 // Close file f. (Decrement ref count, close when reaches 0.) 

5663 void 

5664 fileclose (struct file *f) 

5665 { 

5666 struct file ff; 

5667 

5668 acquire (Sftable . lock) ; 

5669 if(f->ref < 1) 

5670 panic ("fileclose") ; 

5671 if (— f->ref > 0) { 

5672 release (Sftable. lock) ; 

5673 return; 

5674 } 

5675 ff = *f; 

5676 f->ref = 0; 

5677 f->type = FD_NONE; 

5678 release (Sftable. lock) ; 
5679 

5680 iKff.type == FD_PIPE) 

5681 pipeclose (f f .pipe, ff .writable) ; 

5682 else if (ff. type == FD_1N0DE) { 

5683 begin_op(); 

5684 iput(ff.ip); 

5685 end_op(); 

5686 } 

5687 ) 
5688 
5689 
5690 
5691 
5692 
5693 
5694 
5695 
5696 
5697 
5698 
5699 
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5700 // Get metadata about file f. 

5701 int 

5702 filestat (struct file *f, struct stat *st) 

5703 { 

5704 if (f->type == FD_INODE) { 

5705 ilock(f->ip) ; 

5706 stati(f->ip, st); 

5707 iunlock(f->ip) ; 

5708 return 0; 

5709 } 

5710 return -1; 

5711 } 
5712 

5713 // Read from file f. 

5714 int 

5715 fileread (struct file *f, char *addr, int n) 

5716 { 

5717 int r; 
5718 

5719 if (f->readable == 0) 

5720 return -1; 

5721 if (f->type == FD_PIPE) 

5722 return piperead (f->pipe, addr, n) ; 

5723 if (f->tYpe == FD_INODE) { 

5724 ilock(f->ip) ; 

5725 if((r = readl(f->ip, addr, f->off, n) ) > 0) 

5726 f->off += r; 

5727 iunlock(f->ip) ; 

5728 return r; 

5729 ) 

5730 panic ("fileread") ; 

5731 } 
5732 
5733 
5734 
5735 
5736 
5737 
5738 
5739 
5740 
5741 
5742 
5743 
5744 
5745 
5746 
5747 
5748 
5749 
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5750 // Write to file f. 

5751 int 

5752 filewrite (struct file *f, char *addr, int n) 

5753 { 



5754 int r; 
5755 

5756 if (f->writable == 0) 

5757 return -1; 

5758 if (f->tYpe == FD_PIPE) 

5759 return pipewrite (f->pipe, addr, n) ; 

5760 if (f->tYpe == FD_INODE) { 

5761 // write a few blocks at a time to avoid exceeding 

5762 // the maximum log transaction size, including 

5763 // i-node, indirect block, allocation blocks, 

5764 // and 2 blocks of slop for non-aligned writes. 

5765 // this really belongs lower down, since writei{) 

5766 // might be writing a device like the console. 

5767 int max = ( (LOGSIZE-1-1-2) / 2) * 512; 

5768 int i = 0; 

5769 while (i < n) { 

5770 int nl = n - i; 

5771 if(nl > max) 

5772 nl = max; 
5773 

5774 begin_op(); 

5775 ilock(f->ip); 

5776 if ((r = writei (f->ip, addr + i, f->off, nl)) > 0) 

5777 f->off += r; 

5778 iunlock(f->ip) ; 

5779 end_op(); 
5780 

5781 if(r < 0) 

5782 break; 

5783 if(r != nl) 

5784 panicC'short filewrite"); 

5785 i += r; 

5786 } 

5787 return i == n ? n : -1; 

5788 } 

5789 panic ("filewrite") ; 



5790 } 

5791 

5792 

5793 

5794 

5795 

5796 

5797 

5798 

5799 
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5800 
5801 
5802 
5803 
5804 
5805 
5806 
5807 
5808 
5809 
5810 
5811 
5812 
5813 
5814 
5815 
5816 
5817 
5818 
5819 
5820 
5821 
5822 
5823 
5824 
5825 
5826 
5827 
5828 
5829 
5830 
5831 
5832 
5833 
5834 
5835 
5836 
5837 
5838 
5839 
5840 
5841 
5842 
5843 
5844 
5845 
5846 
5847 



// 

// File-system system calls. 

// Mostly argument checking, since we don't trust 
// user code, and calls into file.c and fs.c. 
// 

♦include "types. h" 
♦include "defs.h" 



♦include 
♦include 

#include 
#include 
#include 
♦include 
♦include 



'param.h" 
'stat.h" 

'mmu.h" 

'proc.h" 

'fs.h" 

'file.h" 

'fcntl.h" 



// Fetch the nth word-sized system call argument as a file descriptor 
// and return both the descriptor and the corresponding struct file, 
static int 

argfd(int n, int *pfd, struct file **pf) 
{ 

int fd; 

struct file *f; 



if(argint(n, &fd) < 0) 
return -1; 



fd >= NOFILE II (f=proc->ofile[fd] ) 



if (fd < 0 I 
return -1 

if (pfd) 
*pfd = fd 

if (pf) 
*pf = f; 

return 0; 



// Allocate a file descriptor for the given file. 
// Takes over file reference from caller on success, 
static int 

fdalloc (struct file *f) 
{ 

int fd; 

for(fd = 0; fd < NOFILE; fd++) { 
if (proc->ofile[fd] == 0) { 
proc->of ile [fd] = f; 
return fd; 



0) 



return -1; 



5849 
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5850 int 

5851 sys_dup (void) 

5852 { 

5853 struct file *f; 

5854 int fd; 
5855 

5856 if(argfd(0, 0, Sf) < 0) 

5857 return -1; 

5858 if ( (fd=fdalloc(f) ) < 0) 

5859 return -1; 

5860 filedup(f); 

5861 return fd; 

5862 ) 
5863 

5864 int 

5865 sys_read (void) 

5866 ( 

5867 struct file *f; 

5868 int n; 

5869 char *p; 
5870 

5871 if(argfd(0, 0, &f) < 0 | | argint(2, Sn) < 0 | | argptr(l, &p, n) < 0) 

5872 return -1; 

5873 return fileread(f, p, n) ; 

5874 } 
5875 

5876 int 

5877 sys_write (void) 

5878 { 

5879 struct file *f; 

5880 int n; 

5881 char *p; 
5882 

5883 if(argfd(0, 0, Sf) < 0 | | argint(2, Sn) < 0 | | argptr(l, Sp, n) < 0) 

5884 return -1; 

5885 return filewrite(f, p, n) ; 



5887 



int 

5889 sys_close (void) 

5890 { 

5891 int fd; 

5892 struct file *f; 
5893 

5894 if(argfd(0, Sfd, Sf) < 0) 

5895 return -1; 

5896 proc->ofile[fd] = 0; 

5897 fileclose(f); 

5898 return 0; 

5899 ) 
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5900 int 

5901 sys_f Stat (void) 

5902 { 

5903 struct file *f; 

5904 struct stat *st; 
5905 

5906 if(argfd(0, 0, Sf) < 0 | | argptr(l, (void*)&st, sizeof(*st)) < 0) 

5907 return -1; 

5908 return filestat(f, st); 

5909 } 

5910 

5911 // Create the path new as a link to the same inode as old. 

5912 int 

5913 sysjink (void) 

5914 { 

5915 char name [DIRSIZ] , *new, *old; 

5916 struct inode *dp, *ip; 
5917 

5918 if(argstr(0, Sold) < 0 || argstr(l, Snew) < 0) 

5919 return -1; 
5920 

5921 begin_op(); 

5922 if((ip = namei(old)) == 0) { 

5923 end_op(); 

5924 return -1; 

5925 } 
5926 

5927 ilock(ip); 

5928 if(ip->type == T_D1R) { 

5929 iunlockput (ip) ; 

5930 end_op(); 

5931 return -1; 

5932 } 
5933 

5934 ip->nlink++; 

5935 iupdate (ip) ; 

5936 iunlock (ip) ; 
5937 

5938 if ((dp = nameiparent (new, name)) == 0) 

5939 goto bad; 

5940 ilock(dp); 

5941 if(dp->dev != ip->dev || dirlink(dp, name, ip->inum) < 0) { 

5942 iunlockput (dp) ; 

5943 goto bad; 

5944 } 

5945 iunlockput (dp) ; 
594 6 iput(ip); 

5947 

5948 end_op(); 
5949 
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5950 return 0; 
5951 

5952 bad: 

5953 ilock(ip); 

5954 ip->nlink— ; 

5955 iupdate (ip); 

5956 iunlockput (ip) ; 

5957 end_op(); 

5958 return -1; 

5959 ) 
5960 

5961 //Is the directory dp empty except for "." and ? 

5962 static int 

5963 isdirempty (struct inode *dp) 

5964 ( 

5965 int off; 

5966 struct dirent de; 

5967 

5968 for (of f=2*sizeof (de) ; of f <dp->size; of f +=sizeof (de) ) { 

5969 if(readi(dp, (char*)&de, off, sizeof(de)) != sizeof(de)) 

5970 panic ("isdirempty: readi"); 

5971 if(de.inum != 0) 

5972 return 0; 

5973 } 

5974 return 1; 

5975 } 
5976 
5977 
5978 
5979 
5980 
5981 
5982 
5983 
5984 
5985 
5986 
5987 
5988 
5989 
5990 
5991 
5992 
5993 
5994 
5995 
5996 
5997 
5998 
5999 
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6000 


int 


6001 


sys_unlink (void) 


6002 


{ 


6003 


struct inode *ip, *dp; 


6004 


struct dirent de; 


6005 


char name [DIRSIZ] , *path; 


6006 


uint off; 


6007 




6008 


if(argstr(0, Spath) < 0) 


6009 


return -1; 


6010 




6011 


begin_op ( ) ; 


6012 


if ((dp = nameiparent (path, name)) == 0) { 


6013 


end_op ( ) ; 


6014 


return -1; 


6015 


) 


6016 




6017 


ilock (dp) ; 


6018 




6019 


// Cannot unlink "." or 


6020 


if (namecmp (name, ".") == 0 | | namecmp (name 


6021 


goto bad; 


6022 




6023 


if((ip = dirlookup (dp, name, Sof f ) ) == 0) 


6024 


goto bad; 


6025 


ilock (ip) ; 


6026 




6027 


if(ip->nlink < 1) 


6028 


panic ("unlink: nlink < 1"); 


6029 


if(ip->tYpe == T_DIR SS ! isdirempty (ip) ) { 


6030 


iunlockput (ip) ; 


6031 


goto bad; 


6032 


} 


6033 




6034 


memset(Sde, 0, sizeof(de)); 


6035 


if (writei (dp, (char*)&de, off, sizeof (de) ) 


6036 


panic ( "unlink: writei"); 


6037 


if (ip->tYpe == T_DIR) { 


6038 


dp->nlink — ; 


6039 


iupdate (dp) ; 


6040 


} 


6041 


iunlockput (dp) ; 


6042 




6043 


ip->nlink — ; 


6044 


iupdate (ip) ; 


6045 


iunlockput (ip) ; 


6046 




6047 


end_op ( ) ; 


6048 




6049 


return 0; 
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6050 bad: 

6051 iunlockput (dp) ; 

6052 end_op(); 

6053 return -1; 

6054 } 
6055 

6056 static struct inode* 

6057 create (char *path, short type, short major, short minor) 

6058 { 

6059 uint off; 

6060 struct inode *ip, *dp; 

6061 char name [DIRSIZ] ; 
6062 

6063 if ((dp = nameiparent (path, name)) == 0) 

6064 return 0; 

6065 ilock (dp); 
6066 

6067 if((ip = dirlookup (dp, name, &off ) ) != 0){ 

6068 iunlockput (dp) ; 

6069 ilock (ip); 

6070 if (type == T_FILE ss ip->type == T_FILE) 

6071 return ip; 

6072 iunlockput (ip) ; 

6073 return 0; 

6074 } 
6075 

6076 if((ip = ialloc(dp->dev, type)) == 0) 

6077 panic("create: ialloc"); 
6078 

6079 ilock (ip); 

5080 ip->major = major; 

6081 ip->minor = minor; 

6082 ip->nlink = 1; 

6083 iupdate (ip); 
6084 

6085 if (type == T_DIR) { // Create . and .. entries. 

6086 dp->nlink++; // for ".." 

6087 iupdate (dp); 

5088 //No ip->nlink++ for ".": avoid cyclic ref count. 

6089 if (dirlink(ip, ".", ip->inum) < 0 || dirlink(ip, dp->inum) < 0) 

6090 panic ("create dots"); 

6091 } 
6092 

6093 if (dirlink (dp, name, ip->inum) < 0) 

6094 panic ("create: dirlink"); 
6095 

6096 iunlockput (dp) ; 

5097 

5098 return ip; 

6099 ) 
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6100 int 

6101 sys_open (void) 

6102 { 

6103 char *path; 

6104 int fd, omode; 

6105 struct file *f; 

6106 struct inode *ip; 
6107 

6108 if(argstr(0, Spath) < 0 || argint(l, Somode) < 0) 



6109 return -1; 

6110 

6111 begin_op () ; 

6112 

6113 if (omode S 0_CREATE) { 

6114 ip = create (path, T_FILE, 0, 0); 

6115 if (ip == 0) { 

6116 end_op 0 ; 

6117 return -1; 

6118 ) 

6119 } else { 

6120 if((ip = namei(path)) == 0) { 

6121 end_op(); 

6122 return -1; 

6123 } 

6124 ilock(ip); 

6125 if(ip->type == T_DIR SS omode != 0_RDONLY) { 

6126 iunlockput (ip) ; 

6127 end_op(); 

6128 return -1; 

6129 } 

6130 } 
6131 

6132 if ( (f = fileallocO ) == 0 I I (fd = fdalloc (f ) ) < 0) { 

6133 if(f) 

6134 fileclose(f); 

6135 iunlockput (ip) ; 

6136 end_op 0 ; 

6137 return -1; 



6138 } 

6139 iunlock(ip); 

6140 end_op(); 
6141 

6142 f->type = FD_INODE; 

6143 f->ip = ip; 

6144 f->off = 0; 

6145 f->readable = ! (omode S 0_WRONLY) ; 

6146 f->writable = (omode S 0_WRONLY) || (omode & 0_RDWR) ; 

6147 return fd; 

6148 } 
6149 
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6150 int 

6151 sys_mkdir (void) 

6152 { 

6153 char *path; 

6154 struct inode *ip; 
6155 

6156 begin_op(); 

6157 if(argstr(0, Spath) < 0 || (ip = create (path, T_DIR, 0, 0)) == 0) { 

6158 end_op(); 

6159 return -1; 

6160 ) 

6161 iunlockput (ip) ; 

6162 end_op ( ) ; 

6163 return 0; 

6164 ) 
6165 

6166 int 

6167 sys_mknod (void) 

6168 ( 

6169 struct inode *ip; 

6170 char *path; 

6171 int len; 

6172 int major, minor; 
6173 

6174 begin_op(); 

6175 if ( (len=argstr(0, Spath)) < 0 || 

6176 argint(l, Smajor) < 0 || 

6177 argint(2, Sminor) < 0 I 

6178 (ip = create (path, T_DEV, major, minor)) == 0) { 

6179 end_op(); 

6180 return -1; 

6181 ) 

6182 iunlockput (ip) ; 

6183 end_op ( ) ; 

6184 return 0; 

6185 ) 
6186 
6187 
6188 
6189 
6190 
6191 
6192 
6193 
6194 
6195 
6196 
6197 
6198 
6199 



Sheet 61 



Aug 29 17:09 2014 xv6/sysfile.c Page 9 



6200 int 

6201 sys_chdir (void) 

6202 { 

6203 char *path; 

6204 struct inode *ip; 
6205 

6206 begin_op() ; 

6207 if(argstr(0, Spath) < 0 || (ip = namei(path)) == 0) { 

6208 end_op(); 

6209 return -1; 

6210 ) 

6211 ilock(ip); 

6212 if(ip->tYpe != T_DIR) { 

6213 iunlockput (ip) ; 

6214 end_op(); 

6215 return -1; 

6216 ) 

6217 iunlock (ip) ; 

6218 iput (proc->cwd) ; 

6219 end_op 0 ; 

6220 proc->cwd = ip; 

6221 return 0; 

6222 } 
6223 

6224 int 

6225 sys_exec (void) 

6226 { 

6227 cliar *path, *argv [MAXARG] ; 

6228 int i; 

622 9 uint uargv, uarg; 

6230 

6231 if(argstr(0, Spath) < 0 || argint(l, (int*) Suargv) < 0) { 

6232 return -1; 

6233 } 

6234 memset (argv, 0, sizeof (argv) ) ; 

6235 for (1=0; ; i++) { 

6236 if (i >= NELEM(argv) ) 

6237 return -1; 

6238 if (fetchint (uargv+4*i, (int*)Suarg) < 0) 

6239 return -1; 

6240 if (uarg == 0) { 

6241 argv[i] = 0; 

6242 break; 

6243 } 

6244 if (fetchstr(uarg, Sargv[i]) < 0) 

6245 return -1; 

6246 } 

6247 return exec (path, argv); 

6248 } 
6249 
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6250 int 

6251 sys_pipe (void) 

6252 { 

6253 int *fd; 

6254 struct file *rf, *wf; 

6255 int fdO, fdl; 
6256 

6257 if(argptr(0, (void*)Sfd, 2*sizeof (fd[0] ) ) < 0) 

6258 return -1; 

6259 if (pipealloc(Srf, Swf) < 0) 

6260 return -1; 

6261 fdO = -1; 

6262 if((fdO = fdalloc(rf)) < 0 || (fdl = fdalloc(wf)) < 0) { 

6263 if(fdO >= 0) 

6264 proc->ofile[fdO] = 0; 

6265 f ileclose (rf ) ; 

6266 f ileclose (wf) ; 

6267 return -1; 

6268 ) 

6269 fd[0] = fdO; 

6270 fd[l] = fdl; 

6271 return 0; 

6272 } 
6273 
6274 
6275 
6276 
6277 
6278 
6279 



6281 
6282 
6283 



6285 
6286 
6287 



6290 
6291 
6292 
6293 
6294 
6295 
6296 
6297 
6298 
6299 
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6300 #include "types. h" 

6301 #include "param.h" 

6302 tinclude "memlayout .h" 

6303 tinclude "mmu.h" 

6304 tinclude "proc.h" 

6305 tinclude "defs.h" 

6306 tinclude "x86.h" 

6307 tinclude "elf.h" 
6308 

6309 int 

6310 exec (char *path, char **argv) 

6311 { 



6312 char *s, *last; 

6313 int i, off; 

6314 uint argc, sz, sp, ustack [3+MaXARG+l] ; 

6315 struct elfhdr elf; 

6316 struct inode *ip; 

6317 struct proghdr ph; 

6318 pde_t *pgdir, *oldpgdir; 

6319 

6320 begin_op () ; 

6321 if((ip = namei(path)) == 0) { 

6322 end_op(); 

6323 return -1; 

6324 } 

6325 ilock(ip); 

6326 pgdir = 0; 
6327 

6328 // Check ELF header 

6329 if(readi(ip, (char*) self, 0, sizeof(elf)) < sizeof(elf)) 

6330 goto bad; 

6331 if (elf. magic != ELF_^4AGIC) 

6332 goto bad; 
6333 

6334 if ((pgdir = setupkvmO) == 0) 

6335 goto bad; 
6336 

6337 // Load program into memory. 

6338 sz = 0; 

6339 for(i=0, of f=elf .phof f ; i<elf.phnum; i++, of f+=sizeof (ph) ) { 

6340 if(readi(ip, (char*)&ph, off, sizeof(ph)) != sizeof(ph)) 

6341 goto bad; 

6342 if (ph. type != ELF_PROG_LOAD) 

6343 continue; 

6344 if(ph.memsz < ph.filesz) 

6345 goto bad; 

6346 if((sz = allocuvm (pgdir, sz, ph.vaddr + ph.memsz)) == 0) 

6347 goto bad; 

6348 if (loaduvm (pgdir, (char*)ph.vaddr, ip, ph. off, ph.filesz) < 0) 
634 9 goto bad; 
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6350 } 

6351 iunlockput (ip) ; 

6352 end_op(); 

6353 ip = 0; 
6354 

6355 // Allocate two pages at the next page boundary. 

6356 // Make the first inaccessible. Use the second as the user stack. 

6357 sz = PGROUNDUP (sz) ; 

6358 if((sz = allocuvm (pgdir, sz, sz + 2*PGSIZE) ) == 0) 

6359 goto bad; 

6360 clearpteu (pgdir, (char*) (sz - 2*PGSIZE) ) ; 

6361 sp = sz; 
6362 

6363 // Push argument strings, prepare rest of stack in ustack. 

6364 for (argc = 0; argv[argc]; argc++) { 

6365 if (argc >= MAXARG) 

6366 goto bad; 

6367 sp = (sp - (strlen (argv [argc] ) + 1) ) & ~3; 

6368 if (copyout (pgdir, sp, argv[argc], strlen (argv [argc] ) + 1) < 0) 

6369 goto bad; 

6370 ustack [3+argc] = sp; 

6371 } 

6372 ustack [3+argc] = 0; 
6373 

6374 ustack [0] = Oxffffffff; // fake return PC 

6375 ustack [1] = argc; 

6376 ustack [2] = sp - (argc+l)*4; // argv pointer 
6377 

6378 sp -= (3+argc+l) * 4; 

6379 if (copyout (pgdir, sp, ustack, (3+argc+l) *4) < 0) 

6380 goto bad; 
6381 

6382 // Save program name for debugging. 

6383 f or (last=s=path; *s; s++) 

6384 if(*s == '/') 

6385 last = s+1; 

6386 safestrcpy (proc->name, last, sizeof (proc->name) ) ; 
6387 

6388 // Commit to the user image. 

6389 oldpgdir = proc->pgdir; 

6390 proc->pgdir = pgdir; 

6391 proc->sz = sz; 

6392 proc->tf->eip = elf. entry; // main 

6393 proc->tf->esp = sp; 

6394 switchuvm (proc) ; 

6395 freevm (oldpgdir) ; 

6396 return 0; 
6397 

6398 
6399 
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6400 bad: 

6401 if(pgdir) 

6402 freevm (pgdir) ; 

6403 if(ip){ 

6404 iunlockput (ip) ; 

6405 end_op(); 

6406 } 

6407 return -1; 

6408 } 
6409 

6410 
6411 
6412 
6413 
6414 
6415 
6416 
6417 
6418 
6419 
6420 
6421 
6422 
6423 
6424 
6425 
6426 
6427 
6428 
6429 
6430 
6431 
6432 
6433 
6434 
6435 
6436 
6437 
6438 
6439 
6440 
6441 
6442 
6443 
6444 
6445 
6446 
6447 
6448 
6449 



6450 tinclude "types. h" 

6451 tinclude "defs.h" 

6452 #include "param.h" 

6453 #include "mmu.h" 

6454 #include "proc.h" 

6455 #include "fs.h" 

6456 #include "file.h" 

6457 #include "spinlock.h" 
6458 

6459 #define PIPESIZE 512 

6460 

6461 struct pipe { 

5462 struct spinlock lock; 

6463 char data [PIPESIZE] ; 

6464 uint nread; // number of bytes read 

6465 uint nwrite; // number of bytes written 

6466 int readopen; // read fd is still open 

6467 int writeopen; // write fd is still open 

6468 ); 
6469 

6470 int 

6471 pipealloc (struct file **fO, struct file **fl) 

6472 { 

6473 struct pipe *p; 
6474 

6475 p = 0; 

6476 *fO = *fl = 0; 

6477 if((*fO = fileallocO) == 0 I I (*fl = fileallocO) 

6478 goto bad; 

6479 if((p = (struct pipe*) kalloc () ) == 0) 

6480 goto bad; 

6481 p->readopen = 1; 

6482 p->writeopen = 1; 

6483 p->nwrite = 0; 

6484 p->nread = 0; 

6485 initlock (Sp->lock, "pipe"); 

6486 (*fO)->tYpe = FD_PIPE; 

6487 (*fO)->readable = 1; 

6488 (*fO)->writable = 0; 

6489 (*fO)->pipe = p; 

6490 (*fl)->type = FD_PIPE; 

6491 (*fl)->readable = 0; 

6492 (*fl)->writable = 1; 

6493 (*fl)->pipe = p; 

6494 return 0; 
6495 

6496 
6497 
6498 
6499 
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6500 bad: 



6501 if(p) 

6502 kfree( (char*)p) ; 

6503 if(*fO) 

6504 fileclose(*fO) ; 

6505 if(*fl) 

6506 fileclose(*fl) ; 

6507 return -1; 



6508 } 
6509 

6510 void 

6511 pipeclose (struct pipe *p, int writable) 

6512 { 



6513 acquire (&p->lock) ; 

6514 if (writable) { 

6515 p->writeopen = 0; 

6516 wakeup (5[p->nread) ; 

6517 ) else { 

6518 p->readopen = 0; 

6519 wakeup (&p->nwrite) ; 

6520 } 

6521 if (p->readopen == 0 &S p->writeopen == 0) { 

6522 release (&p->lock) ; 

6523 kfree( (char*)p); 

6524 } else 

6525 release (Sp->lock) ; 



6526 } 

6527 

6528 

6529 int 

6530 pipewrite (struct pipe *p, char *addr, int n) 

6531 ( 

6532 int i; 
6533 

6534 acquire (&p->lock) ; 

6535 for (i = 0; i < n; i++) ( 



6536 while (p->nwrite == p->nread + PIPESIZE) { 

6537 if (p->readopen == 0 | | proc->killed) { 

6538 release (Sp->lock) ; 

6539 return -1; 

6540 } 

6541 wakeup (Sp->nread) ; 

6542 sleep (&p->nwrite, &p->lock) ; 

6543 } 

6544 p->data [p->nwrite++ % PIPESIZE] = addr[i]; 



6545 } 

6546 wakeup (&p->nread) ; 

6547 release (&p->lock) ; 

6548 return n; 

6549 } 
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6550 int 

6551 piperead (struct pipe *p, char *addr, int n) 

6552 { 

6553 int i; 
6554 

6555 acquire (&p->lock) ; 

6556 while (p->nread == p->nwrite S& p->writeopen) 

6557 if (proc->killed) { 

6558 release (Sp->lock) ; 

6559 return -1; 

6560 } 

6561 sleep (Sp->nread, Sp->lock) ; 

6562 ) 

6563 for(i = 0; i < n; i++) { 
5564 if (p->nread == p->nwrite) 

6565 break; 

6566 addr[i] = p->data [p->nread++ % PIPESIZE]; 

6567 ) 

6568 wakeup (Sp->nwrite) ; 

6569 release (Sp->lock) ; 

6570 return i; 

6571 } 
6572 
6573 
6574 
6575 
6576 
6577 
6578 
6579 
6580 
6581 
6582 
6583 
6584 
6585 
6586 
6587 
6588 
6589 
6590 
6591 
6592 
6593 
6594 
6595 
6596 
6597 
6598 
6599 
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6600 


♦include "types. h" 


6650 


// memcpY exists to placate GCC. Use memmove. 


6601 


♦include "x86.h" 


6651 


void* 


6602 




6652 


memcpy(void *dst, const void *src, uint n) 


6603 


void* 


6653 


{ 


6604 memset (void *dst, int c, uint n) 


6654 


return memmove (dst, src, n) ; 


6605 


{ 


6655 


} 


6606 


if ((int)dst%4 == 0 SS n%4 == 0) { 


6656 




6607 


c &= OxFF; 


6657 


int 


6608 


stosl(dst, (c«24) 1 (c«16) 1 (c«8) |c, n/4); 


6658 


strncmp (const char *p, const char *q, uint n) 


6609 


} else 


6659 


{ 


6610 


stosb(dst, c, n) ; 


6660 


while (n > 0 SS *p S& *p == *q) 


6611 


return dst; 


6661 


n--, P++, q++; 


6612 


} 


6662 


if (n == 0) 


6613 




6663 


return 0; 


6614 


int 


6664 


return (uchar) *p - (uchar) *q; 


6515 memcmp (const void *vl, const void *v2, uint n) 


6665 


} 


6616 


( 


6666 




6617 


const uchar *sl, *s2; 


6667 


char* 


6618 




6668 


strncpy(char *s, const char *t, int n) 


6619 


si = vl; 


6669 


{ 


6620 


s2 = v2; 


6670 


char *os; 


6621 


while (n— > 0) ( 


6671 




6622 


if(*sl != *s2) 


6672 


OS = s; 


6623 


return *sl - *s2; 


6673 


while (n— > 0 SS (*s++ = *t++) != 0) 


6624 


sl++, s2++; 


6674 




6625 


} 


6675 


while (n— > 0) 


6626 




6676 


*s++ = 0; 


6627 


return 0; 


6677 


return os; 


6628 


} 


6678 


) 


6629 




6679 




6630 


void* 


6680 


// Like strncpY but guaranteed to NUL-terminate 


6631 memmove (void *dst, const void *src, uint n) 


6681 


char* 


6632 


{ 


6682 


saf estrcpY (char *s, const char *t, int n) 


6633 


const char *s; 


6683 


( 


6634 


char *d; 


6684 


char *os; 


6635 




6685 




6636 


s = src; 


6686 


OS = s; 


6637 


d = dst; 


6687 


if(n <= 0) 


6638 


if (s < d S& s + n > d) { 


6688 


return os; 


6639 


s += n; 


6689 


while (~n > 0 SS (*s++ = *t++) != 0) 


6640 


d += n; 


6690 




6641 


while (n~ > 0) 


6691 


*s = 0; 


6642 


*— d = *— s; 


6692 


return os; 


6643 


} else 


6693 


} 


6644 


while (n~ > 0) 


6694 




6645 


*d++ = *s++; 


6695 




6646 




6696 




6647 


return dst; 


6697 




6648 


} 


6698 




6649 




6699 
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6700 int 


6750 


// See Multiprocessor Specification Version l.[14] 


6701 strlen (const char *s) 


6751 






6702 { 


6752 


struct mp { 


// floating pointer 


6703 int n; 


6753 


uchar signature [4] ; 


// "_MP_" 


6704 


6754 


void *physaddr; 


/ / phys addr of MP conf ig table 


6705 for(n = 0; s[n]; n++) 


6755 


uchar length; 


// 1 


6706 ; 


6756 


uchar specrev; 


// [14] 


6707 return n; 


6757 


uchar checksum; 


// all bytes must add up to 0 


6708 } 


6758 


uchar type; 


//MP system config type 


6709 


6759 


uchar imcrp; 




6710 


6760 


uchar reserved[3] ; 




6711 


6761 


}; 




6712 


6762 






6713 


6763 


struct mpconf ( 


// configuration table header 


6714 


6764 


uchar signature [4] ; 


// "PCMP" 


6715 


6765 


ushort length; 


// total table length 


6716 


6766 


uchar version; 


// [14] 


6717 


6767 


uchar checksum; 


// all bytes must add up to 0 


6718 


6768 


uchar product [20]; 


// product id 


6719 


6769 


uint *oemtable; 


// OEM table pointer 


6720 


6770 


ushort oemlength; 


// OEM table length 


6721 


6771 


ushort entry; 


// entry count 


6722 


6772 


uint *lapicaddr; 


// address of local APIC 


6723 


6773 


ushort xlength; 


// extended table length 


6724 


6774 


uchar xchecksum; 


// extended table checksum 


6725 


6775 


uchar reserved; 




6726 


6776 


}; 




6727 


6777 






6728 


6778 


struct mpproc { 


// processor table entry 


6729 


6779 


uchar type; 


// entry type (0) 


6730 


6780 


uchar apicid; 


// local APIC id 


6731 


6781 


uchar version; 


// local APIC verison 


6732 


6782 


uchar flags; 


// CPU flags 


6733 


6783 


♦define MPBOOT 0x02 


// This proc is the bootstrap processor 


6734 


6784 


uchar signature [4] ; 


// CPU signature 


6735 


6785 


uint feature; 


// feature flags from CPUID instruction 


6736 


6786 


uchar reserved [8]; 




6737 


6787 


); 




6738 


6788 






6739 


6789 


struct mpioapic { 


// I/O APIC table entry 


6740 


6790 


uchar type; 


// entry type (2) 


6741 


6791 


uchar apicno; 


// I/O APIC id 


6742 


6792 


uchar version; 


// I/O APIC version 


6743 


6793 


uchar flags; 


// I/O APIC flags 


6744 


6794 


uint *addr; 


// I/O APIC address 


6745 


6795 


); 




6746 


6796 






6747 


6797 






6748 


6798 






6749 


6799 
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6800 // Table entry types 6850 // Blank page. 

6801 #define MPPROC 0x00 // One per processor 6851 

6802 tdefine MPBUS 0x01 // One per bus 6852 

6803 tdefine MPIOAPIC 0x02 // One per I/O APIC 6853 

6804 tdefine MPIOINTR 0x03 // One per bus interrupt source 6854 

6805 tdefine MPLINTR 0x04 // One per system interrupt source 6855 

6806 6856 

6807 6857 

6808 6858 

6809 6859 

6810 6860 

6811 6861 

6812 6862 

6813 6863 

6814 6864 

6815 6865 

6816 6866 

6817 6867 

6818 6868 

6819 6869 

6820 6870 

6821 6871 

6822 6872 

6823 6873 

6824 6874 

6825 6875 

6826 6876 

6827 6877 

6828 6878 

6829 6879 

6830 6880 

6831 6881 

6832 6882 

6833 6883 

6834 6884 

6835 6885 

6836 6886 

6837 6887 

6838 6888 

6839 6889 

6840 6890 

6841 6891 

6842 6892 

6843 6893 

6844 6894 

6845 6895 

6846 6896 

6847 6897 

6848 6898 

6849 6899 
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6900 // Multiprocessor support 

6901 // Search memory for MP description structures. 

6902 // http://developer.intel.com/design/pentium/datashts/24201606.pdf 
6903 

6904 tinclude "types. h" 

6905 tinclude "defs.h" 

6906 tinclude "param.h" 

6907 tinclude "memlayout .h" 

6908 tinclude "mp.h" 

6909 tinclude "x86.h" 

6910 #include "mmu.h" 

6911 #include "proc.h" 
6912 

6913 struct cpu cpus[NCPU]; 

6914 static struct cpu *bcpu; 

6915 int ismp; 

6916 int ncpu; 

6917 uchar ioapicid; 
6918 

6919 int 

6920 mpbcpu(void) 

6921 { 

6922 return bcpu-cpus; 

6923 } 
6924 

6925 static uchar 

6926 sum(uchar *addr, int len) 

6927 { 

6928 int i, sum; 

6929 

6930 sum = 0; 

6931 for (1=0; i<len; i++) 

6932 sum += addr [i] ; 

6933 return sum; 

6934 } 
6935 

6936 // Look for an MP structure in the len bytes at addr. 

6937 static struct mp* 

6938 mpsearchl (uint a, int len) 

6939 { 

6940 uchar *e, *p, *addr; 
6941 

6942 addr = p2v(a) ; 

6943 e = addr+len; 

6944 for(p = addr; p < e; p += sizeof (struct mp) ) 

6945 if(memcmp(p, "_MP_", 4) == 0 S& sum(p, sizeof (struct mp) ) == 0) 

6946 return (struct mp*)p; 

6947 return 0; 

6948 } 
6949 
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6950 // Search for the MP Floating Pointer Structure, which according to the 

6951 // spec is in one of the following three locations: 

6952 // 1) in the first KB of the EBDA; 

6953 // 2) in the last KB of system base memory; 

6954 // 3) in the BIOS ROM between OxEOOOO and OxFFFFF. 

6955 static struct mp* 

6956 mpsearch (void) 

6957 { 

6958 uchar *bda; 

6959 uint p; 

6960 struct mp *mp; 

6961 

6962 bda = (uchar *) P2V(0x400); 

6963 if((p = ( (bda[0x0F]«8) I bda[OxOE]) « 4)){ 

6964 if ( (mp = mpsearchl (p, 1024))) 

6965 return mp; 

6966 } else { 

6967 p= ( (bda[0xl4]«8) |bda[0xl3] ) *1024; 

6968 if ( (mp = mpsearchl (p-1024, 1024))) 

6969 return mp; 

6970 } 

6971 return mpsearchl (OxFOOOO, 0x10000); 

6972 } 
6973 

6974 // Search for an MP configuration table. For now, 

6975 // don't accept the default configurations (physaddr == 0) . 

6976 // Check for correct signature, calculate the checksum and, 

6977 // if correct, check the version. 

6978 // To do: check extended table checksum. 

6979 static struct mpconf* 

6980 mpconf ig (struct mp **pmp) 

6981 { 

6982 struct mpconf *conf; 

6983 struct mp *mp; 

6984 

6985 if((mp = mpsearchO) == 0 | | mp->physaddr == 0) 

6986 return 0; 

6987 conf = (struct mpconf*) p2v((uint) mp->physaddr) ; 

6988 if (memcmp(conf, "PCMP", 4) != 0) 

6989 return 0; 

6990 if (conf->version != 1 S5 conf->version != 4) 

6991 return 0; 

6992 if (sum((uchar*)conf, conf->length) != 0) 

6993 return 0; 
5994 *pmp = mp; 

6995 return conf; 

6996 ) 
6997 

6998 
6999 
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7000 void 

7001 mpinit (void) 

7002 { 

7003 uchar *p, *e; 

7004 struct mp *rap; 

7005 struct mpconf *conf; 

7006 struct mpproc *proc; 

7007 struct mpioapic *ioapic; 
7008 

7009 bcpu = Scpus [0] ; 

7010 if((conf = mpconf ig (Srap) ) == 0) 



7011 return; 

7012 ismp = 1; 

7013 lapic = (uint*) conf->lapicaddr; 

7014 for (p= (uchar*) (conf+1) , e= (uchar*) conf+conf->length; p<e; ){ 

7015 switch (*p){ 

7016 case MPPROC: 

7017 proc = (struct mpproc*) p; 

7018 if(ncpu != proc->apicid) { 

7019 cprintf ("mpinit : ncpu=%d apicid=%d\n", ncpu, proc->apicid) ; 

7020 ismp = 0; 

7021 } 

7022 if (proc->flags & MPBOOT) 

7023 bcpu = &cpus[ncpu]; 

7024 cpus [ncpu] . id = ncpu; 

7025 ncpu++; 

7026 p += sizeof (struct mpproc); 

7027 continue; 

7028 case MPIOAPIC: 

7029 ioapic = (struct mpioapic*)p; 

7030 ioapicid = ioapic->apicno; 

7031 p += sizeof (struct mpioapic); 

7032 continue; 

7033 case MPBUS: 

7034 case MPIOINTR: 

7035 case MPLINTR: 

7036 p += 8; 

7037 continue; 

7038 default: 

7039 cprintf ("mpinit : unknown config type %x\n", *p) ; 

7040 ismp = 0; 

7041 } 

7042 } 

7043 if(!ismp){ 

7044 // Didn't like what we found; fall back to no MP. 

7045 ncpu = 1; 

7046 lapic = 0; 

7047 ioapicid = 0; 

7048 return; 

7049 } 
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7050 if (mp->imcrp) { 

7051 // Bochs doesn't support IMCR, so this doesn't run on Bochs. 

7052 // But it would on real hardware. 

7053 outb(0x22, 0x70); // Select IMCR 

7054 outb(0x23, inb(0x23) | 1); // Mask external interrupts. 

7055 } 

7056 } 
7057 
7058 
7059 
7060 
7061 
7062 
7063 
7064 
7065 
7066 
7067 
7068 
7069 
7070 
7071 
7072 
7073 
7074 
7075 
7076 
7077 
7078 
7079 
7080 
7081 
7082 
7083 
7084 
7085 
7086 
7087 
7088 
7089 
7090 
7091 
7092 
7093 
7094 
7095 
7096 
7097 
7098 
7099 
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7100 
7101 
7102 
7103 
7104 
7105 
7106 
7107 
7108 
7109 
7110 
7111 
7112 
7113 
7114 
7115 
7116 
7117 
7118 
7119 
7120 
7121 
7122 
7123 
7124 
7125 
7126 
7127 
7128 
7129 
7130 
7131 
7132 
7133 
7134 
7135 
7136 
7137 
7138 
7139 
7140 
7141 
7142 
7143 
7144 
7145 
7146 
7147 
7148 
7149 



// The local APIC manages internal (non-I/0) interrupts. 

// See Chapter 8 & Appendix C of Intel processor manual volume 3. 

tinclude "types. h" 
tinclude "defs.h" 



tinclude 
tinclude 
tinclude 
tinclude 



'memlayout .h" 
'traps .h" 
'mmu.h" 
'x86.h" 



// Local APIC registers, divided by 4 for use as uint[] indices. 



#define ID (i 
♦define VER (i 
♦define TPR (l 
♦define EOI (i 
♦ define SVR (i 

♦define ENABLE 
♦define ESR (i 
♦define ICRLO (l 
♦define INIT 
♦define STARTUP 
♦define DELIVS 
tdefine ASSERT 
tdefine DEASSERT 
tdefine LEVEL 
tdefine BCAST 
tdefine BUSY 
tdefine FIXED 
♦define ICRHI 
♦define TIMER (0 
♦define XI 
♦define PERIODIC 
♦define PCINT ( 
♦define LINTO (0 
♦define LINTl ( 
♦define ERROR ( 
♦define MASKED 
♦define TICR ( 
♦define TCCR ( 
tdefine TDCR (0 



// 
// 
// 
// 
// 



X0020/4) 
X0030/4) 
X0080/4) 
xOOBO/4) 
xOOFO/4) 

0x00000100 
X0280/4) // 
X0300/4) // 
0x00000500 
0x00000600 
0x00001000 
0x00004000 
0x00000000 
0x00008000 
0x00080000 
0x00001000 
0x00000000 
X0310/4) // 
X0320/4) // 
OxOOOOOOOB 
0x00020000 
X0340/4) // 
X0350/4) 
X0360/4) 
X0370/4) 

0x00010000 
X0380/4) // 
X0390/4) // 
X03E0/4) // 



// 
// 
// 



ID 

Version 

Task Priority 

EOI 

Spurious Interrupt Vector 

// Unit Enable 
Error Status 
Interrupt Command 

// INIT/RESET 

// Startup IPI 

// Delivery status 

// Assert interrupt (vs deassert) 

// Level triggered 

// Send to all APICs, including se 



Interrupt Command [63:32] 
Local Vector Table 0 (TIMER) 

// divide counts by 1 

// Periodic 
Performance Counter LVT 
Local Vector Table 1 (LINTO) 
Local Vector Table 2 (LINTl) 
Local Vector Table 3 (ERROR) 

// Interrupt masked 
Timer Initial Count 
Timer Current Count 
Timer Divide Configuration 



volatile uint *lapic; // Initialized in mp.c 
static void 

lapicw(int index, int value) 
{ 

lapic [index] = value; 

lapic[ID]; // wait for write to finish, by reading 
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7150 void 

7151 lapicinit (void) 

7152 { 

7153 if(!lapic) 

7154 return; 
7155 

7156 // Enable local APIC; set spurious interrupt vector. 

7157 lapicw(SVR, ENABLE j (T_IRQO + IRQ_SPURIOUS) ) ; 
7158 

7159 // The timer repeatedly counts down at bus frequency 

7160 // from lapic[TICR] and then issues an interrupt. 

7161 //If xv6 cared more about precise timekeeping, 

7162 // TICR would be calibrated using an external time source. 

7163 lapicw(TDCR, XI); 

7164 lapicw(TIMER, PERIODIC I (T_IRQO + IRQ_TIMER) ) ; 

7165 lapicw(TICR, 10000000); 
7166 

7167 // Disable logical interrupt lines. 

7168 lapicw(LINT0, MASKED); 

7169 lapicw(LINTl, MASKED); 
7170 

7171 // Disable performance counter overflow interrupts 

7172 // on machines that provide that interrupt entry. 

7173 if (( (lapic [VER] »16) S OxFF) >= 4) 

7174 lapicw (PCINT, MASKED); 
7175 

7176 // Map error interrupt to IRQ_ERROR. 

7177 lapicw (ERROR, T_IRQO + IRQ_ERROR) ; 
7178 

7179 // Clear error status register (requires back-to-back writes) 

7180 lapicw(ESR, 0); 

7181 lapicw(ESR, 0); 

7182 

7183 // Ack any outstanding interrupts. 

7184 lapicw(EOI, 0); 
7185 

7186 // Send an Init Level De-Assert to synchronise arbitration ID 

7187 lapicwdCRHI, 0); 

7188 lapicw(ICRLO, BCAST j INIT j LEVEL); 

7189 while (lapic [ICRLO] & DELIVS) 

7190 ; 
7191 

7192 // Enable interrupts on the APIC (but not on the processor) . 

7193 lapicw (TPR, 0); 

7194 } 
7195 
7196 
7197 
7198 
7199 
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7200 


int 


7250 


wrv = (ushort*)P2V( (0x40«4 j 0x67)); // Warm reset vector 


7201 


cpunum(void) 


7251 


wrv[0] = 0; 


7202 


{ 


7252 


wrv[l] = addr » 4; 


7203 


// Cannot call cpu when interrupts are enabled: 


7253 




7204 


// result not guaranteed to last long enough to be used! 


7254 


// "Universal startup algorithm." 


7205 


// Would prefer to panic but even printing is chancy here: 


7255 


// Send INIT (level-triggered) interrupt to reset other CPU. 


7206 


// almost everything, including cprintf and panic, calls cpu. 


7256 


lapicw(ICRHI, apicid«24); 


7207 


// often indirectly through acquire and release. 


7257 


lapicw(ICRLO, INIT 1 LEVEL | ASSERT); 


7208 


if (readeflags()SFL_IF) { 


7258 


microdelay (200) ; 


7209 


static int n; 


7259 


lapicw(ICRLO, INIT 1 LEVEL); 


7210 


if(n++ == 0) 


7260 


microdelay (100) ; // should be 10ms, but too slow in Bochs! 


7211 


cprintf ("cpu called from %x with interrupts enabled\n", 


7261 




7212 


builtin_return_address (0) ) ; 


7262 


// Send startup IPI (twice!) to enter code. 


7213 


} 


7263 


// Regular hardware is supposed to only accept a STARTUP 


7214 




7264 


// when it is in the halted state due to an INIT. So the second 


7215 


if (lapic) 


7265 


// should be ignored, but it is part of the official Intel algorithm 


7216 


return lapic [ID] »24; 


7266 


// Bochs complains about the second one. Too bad for Bochs. 


7217 


return 0; 


7267 


for(i =0; i < 2; i++) { 


7218 


} 


7268 


lapicw(ICRHI, apicid<<24); 


7219 




7269 


lapicw(ICRLO, STARTUP | (addr»12)); 


7220 


/ / Acknowledge interrupt . 


7270 


microdelay (200) ; 


7221 


void 


7271 


} 


7222 


lapiceoi (void) 


7272 ; 


[ 


7223 


{ 


7273 




7224 


if (lapic) 


7274 




7225 


lapicw(EOI, 0); 


7275 




7226 


} 


7276 




7227 




7277 




7228 


// Spin for a given number of microseconds. 


7278 




7229 


// On real hardware would want to tune this dynamically. 


7279 




7230 


void 


7280 




7231 microdelay (int us) 


7281 




7232 


{ 


7282 




7233 


} 


7283 




7234 




7284 




7235 


♦define IO_RTC 0x70 


7285 




7236 




7286 




7237 


// Start additional processor running entry code at addr. 


7287 




7238 


// See Appendix B of Multiprocessor Specification. 


7288 




7239 


void 


7289 




7240 


lapicstartap (uchar apicid, uint addr) 


7290 




7241 


{ 


7291 




7242 


int i; 


7292 




7243 


ushort *wrv; 


7293 




7244 




7294 




7245 


// "The BSP must initialize CMOS shutdown code to OAH 


7295 




7246 


// and the warm reset vector (DWORD based at 40:67) to point at 


7296 




7247 


// the AP startup code prior to the [universal startup algorithm]." 


7297 




7248 


outb{IO_RTC, OxF) ; // offset OxF is shutdown code 


7298 




7249 


outb(IO_RTC+l, OxOA) ; 


7299 
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7300 // The I/O APIC manages hardware interrupts for an SMP system. 

7301 // http:/ /www. Intel . com/design/chipset s/datashts/2 905 5601 .pdf 

7302 // See also picirq.c. 
7303 

7304 finclude "types. h" 

7305 finclude "defs.h" 

7306 finclude "traps. h" 
7307 

7308 fdefine lOAPIC OxFECOOOOO // Default physical address of 10 APIC 
7309 

7310 #define REG_ID 0x00 // Register index: ID 

7311 #define REG_VER 0x01 // Register index: version 

7312 fdefine REG_TABLE 0x10 // Redirection table base 
7313 

7314 // The redirection table starts at REG_TABLE and uses 

7315 // two registers to configure each interrupt. 

7316 // The first (low) register in a pair contains configuration bits. 

7317 // The second (high) register contains a bitmask telling which 

7318 // CPUs can serve that interrupt. 

7319 fdefine INT_DISABLED OxOOOIOOOO // Interrupt disabled 

7320 fdefine INT_LEVEL 0x00008000 // Level-triggered (vs edge-) 

7321 fdefine INT_ACTIVELOW 0x00002000 // Active low (vs high) 

7322 fdefine INT_LOGICAL 0x00000800 // Destination is CPU id (vs APIC 
7323 

7324 volatile struct ioapic *ioapic; 
7325 

7326 // 10 APIC MMIO Structure: write reg, then read or write data. 

7327 struct ioapic { 

7328 uint reg; 

7329 uint pad[3]; 

7330 uint data; 

7331 }; 
7332 

7333 static uint 

7334 ioapicread (int reg) 

7335 { 

7336 ioapic->reg = reg; 

7337 return ioapic->data; 

7338 } 
7339 

7340 static void 

7341 ioapicwrite (int reg, uint data) 

7342 { 

7343 ioapic->reg = reg; 

7344 ioapic->data = data; 

7345 } 
7346 
7347 
7348 
7349 



Sheet 73 



Aug 29 17:09 2014 xv6/ioapic.c Page 2 



7350 void 

7351 ioapicinit (void) 

7352 { 

7353 int i, id, maxintr; 
7354 

7355 if(!ismp) 

7356 return; 
7357 

7358 ioapic = (volatile struct ioapic*) IOAPIC; 

7359 maxintr = (ioapicread (REG_VER) » 16) & OxFF; 

7360 id = ioapicread (REG_ID) » 24; 

7361 if(id != ioapicid) 

7362 cprintf ("ioapicinit : id isn't equal to ioapicid; not a MP\n 

7363 

7364 // Mark all interrupts edge-triggered, active high, disabled, 

7365 // and not routed to any CPUs. 

7366 for(i = 0; i <= maxintr; i++) { 

7367 ioapicwrite (REG_TABLE+2*i, INT_DISABLED | (T_IRQO + i) ) ; 

7368 ioapicwrite (REG_TABLE+2*i+l, 0); 

7369 } 

7370 ) 
7371 

7372 void 

7373 ioapicenable (int irq, int cpunum) 

7374 { 

7375 if(!ismp) 

7376 return; 
7377 

7378 // Mark interrupt edge-triggered, active high, 

7379 // enabled, and routed to the given cpunum, 

7380 // which happens to be that cpu's APIC ID. 

7381 ioapicwrite (REG_TABLE+2*irq, T_IRQO + irq) ; 

7382 ioapicwrite (REG_TABLE+2*irq+l, cpunum « 24); 

7383 ) 
7384 
7385 
7386 
7387 
7388 
7389 
7390 
7391 
7392 
7393 
7394 
7395 
7396 
7397 
7398 
7399 
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7400 


// Intel 8259A programmable interrupt controllers. 


7450 


// ICW3: (master PIC) bit mask of IR lines connected to slaves 


7401 




7451 


// (slave PIC) 3-bit # of slave's connection to master 


7402 


tinclude "types. h" 


7452 


outb(IO_PICl+l, 1«IRQ_SLAVE) ; 


7403 


♦include "x86.h" 


7453 




7404 


tinclude "traps. h" 


7454 


// ICW4: OOOnbmap 


7405 




7455 


// n: 1 = special fully nested mode 


7406 


// I/O Addresses of the two programmable interrupt controllers 


7456 


// b: 1 = buffered mode 


7407 


♦define I0_PIC1 0x20 // Master (IRQs 0-7) 


7457 


// m: 0 = slave PIC, 1 = master PIC 


7408 


♦define I0_PIC2 OxAO // Slave (IRQs 8-15) 


7458 


// (ignored when b is 0, as the master/slave role 


7409 




7459 


// can be hardwired) . 


7410 


♦define IRQ_SLAVE 2 // IRQ at which slave connects to master 


7460 


// a: 1 = Automatic EOI mode 


7411 




7461 


// p: 0 = MCS-80/85 mode, 1 = Intel x86 mode 


7412 


// Current IRQ mask. 


7462 


outb(IO_PICl+l, 0x3); 


7413 


// Initial IRQ mask has interrupt 2 enabled (for slave 8259A) . 


7463 




7414 


static ushort irqmask = OxFFFF S ~ (1«IRQ_SLAVE) ; 


7464 


// Set up slave (8259A-2) 


7415 




7465 


outb(I0_PIC2, 0x11); // ICWl 


7416 


static void 


7466 


outb(I0_PIC2+l, T_IRQ0 + 8); // ICW2 


7417 


picsetmask (ushort mask) 


7467 


outb(I0_PIC2+l, IRQ_SLAVE); // ICW3 


7418 


{ 


7468 


/ / NB Automatic EOI mode doesn't tend to work on the slave. 


7419 


irqmask = mask; 


7469 


// Linux source code says it's "to be investigated". 


7420 


outb(IO_PICl+l, mask); 


7470 


outb(I0_PIC2+l, 0x3); // ICW4 


7421 


outb(I0_PIC2+l, mask » 8); 


7471 




7422 


} 


7472 


// 0CW3: OefOlprs 


7423 




7473 


// ef: Ox = NOP, 10 = clear specific mask, 11 = set specific 


7424 


void 


7474 


// p: 0 = no polling, 1 = polling mode 


7425 picenable (int irq) 


7475 


// rs: Ox = NOP, 10 = read IRR, 11 = read ISR 


7426 


{ 


7476 


outb (I0_PIC1, 0x68); // clear specific mask 


7427 


picsetmask (irqmask & ~(l«irq)); 


7477 


outb(IO_PICl, OxOa); // read IRR by default 


7428 


} 


7478 




7429 




7479 


outb(I0_PIC2, 0x68); // 0CW3 


7430 


// Initialize the 8259A interrupt controllers. 


7480 


outb(I0_PIC2, OxOa); // 0CW3 


7431 


void 


7481 




7432 


picinit (void) 


7482 


if (irqmask != OxFFFF) 


7433 


{ 


7483 


picsetmask (irqmask) ; 


7434 


// mask all interrupts 


7484 ) 




7435 


outb(IO_PICl+l, OxFF); 


7485 




7436 


outb(I0_PIC2+l, OxFF); 


7486 




7437 




7487 




7438 


// Set up master (8259A-1) 


7488 




7439 




7489 




7440 


// ICWl: OOOlgOhi 


7490 




7441 


// g: 0 = edge triggering, 1 = level triggering 


7491 




7442 


// h: 0 = cascaded PICs, 1 = master only 


7492 




7443 


// i: 0 = no ICW4, 1 = ICW4 required 


7493 




7444 


outb(IO_PICl, 0x11); 


7494 




7445 




7495 




7446 


// ICW2: Vector offset 


7496 




7447 


outb(IO_PICl+l, T_IRQO); 


7497 




7448 




7498 




7449 




7499 
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7500 


//PC keyboard interface constants 


7501 










7502 


tdef ine 


KBSTATP 


0x64 


// 


7503 


#def ine 


KBS_DIB 


0x01 


// 


7504 


tdef ine 


KBDATAP 


0x60 


// 


7505 










7506 


tdef ine 


NO 


0 




7507 










7508 


tdef ine 


SHIFT 


(1«0) 




7509 


tdef ine 


CTL 


(1«1) 




7510 


tdef ine 


ALT 


(1«2) 




7511 










7512 


tdef ine 


CAPSLOCK 


(1«3) 




7513 


tdef ine 


NUMLOCK 


(1«4) 




7514 


tdef ine 


SCROLLLOCK 


(1«5) 




7515 










7516 


tdef ine 


EOESC 


(1«6) 




7517 










7518 


// Special keycodes 






7519 


tdef ine 


KEYJOME 


OxEO 




7520 


tdef ine 


KEY_END 


OxEl 




7521 


tdef ine 


KEY_UP 


OxE2 




7522 


tdef ine 


KEY_DN 


0xE3 




7523 


tdef ine 


KEY_LF 


OxE4 




7524 


tdef ine 


KEY_RT 


OxE5 




7525 


tdef ine 


KEY_PGUP 


0xE6 




7526 


tdef ine 


KEY_PGDN 


OxE7 




7527 


tdefine 


KEY_INS 


OxES 




7528 


tdef ine 


KEY_DEL 


0xE9 




7529 










7530 


// C('A' 


) == Control-A 






7531 


tdefine 


C(x) (X - '@') 






7532 










7533 


static uchar shiftcode [256] = 




7534 


{ 








7535 


[OxlD] 


CTL, 






7536 


[Ox2a: 


SHIFT, 






7537 


[0x36: 


SHIFT, 






7538 


[0x38] 


ALT, 






7539 


[0x9D] 


CTL, 






7540 


[0xB8] 


ALT 






7541 


}; 








7542 










7543 


static uchar togglecode [256] = 




7544 


{ 








7545 


[0x3A] 


CAPSLOCK, 






7546 


[0x45] 


NUMLOCK, 






7547 


[0x46] 


SCROLLLOCK 






7548 


}; 








7549 











kbd controller status port (I) 
kbd data in buffer 
kbd data port (I) 
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7550 


static uchar normalmap [256] = 












7551 


( 




















7552 


NO, 


OxlB 




'2', 


'3', 


'4', 


'5', 


' 6' , 


// 


0x00 


7553 


'7', 


'8', 


'9', 


'0', 


f _r 


t — f 


'\b' 


'\t' 






7554 


'q'» 


'w' , 


'e', 


'r', 


't'. 


'y' r 


'u', 




// 


0x10 


7555 


'o' , 


' P' r 


' [' r 


' ] ' , 


'\n' 


NO, 


'a', 


's'. 






7556 


'd', 


'i' , 


'g'r 


'h', 


'V, 


'k'. 




t . f 


// 


0x20 


7557 


'\", 




NO, 


'W, 


'z'. 


'X', 


'C, 


'V, 






7558 


'b', 


' n' , 


'm' , 




/ t 


'/', 


NO, 


' * ' 


// 


0x30 


7559 


NO, 




NO, 


NO, 


NO, 


NO, 


NO, 


NO, 






7560 


NO, 


NO, 


NO, 


NO, 


NO, 


NO, 


NO, 


'7', 


// 


0x40 


7561 


'8', 


' 9' , 




'4', 


'5', 


' 6' , 


'+', 


'1', 






7562 


'2' , 


'3', 


' 0' , 


r r 


NO, 


NO, 


NO, 


NO, 


// 


0x50 


7563 


[0x9C] 


'\n 




II KP 


Enter 










7564 


[OxB5] 


'/' 




// KP_ 


Div 












7565 


[0xC8] 


KEY, 


_UP, 


[OxDO] 


KEY, 


,DN, 










7566 


[0xC9] 


KEY, 


,PGUP, 


[OxDl] 


KEY, 


,PGDN, 










7567 


[OxCB] 


KEY, 


_LF, 


[OxCD] 


KEY, 


,RT, 










7568 


[0x97] 


KEY, 


,HOME, 


[OxCF] 


KEY, 


,END, 










7569 


[0xD2] 


KEY. 


.INS, 


[0xD3] 


KEY. 


.DEL 










7570 


); 




















7571 






















7572 


static uchar 


shiftmap[256] 














7573 


{ 




















7574 


NO, 


033, 


' 1 ' 

■ r 


'V , 


'#', 




'%', 


f 


// 


0x00 


7575 




f *f 


' {', 


')' , 


f r 
— t 


'+', 


'\b' 


'\t' 






7576 


'Q', 


'W , 


'E', 


'R' , 


'V , 


'Y', 


'U', 


'I', 


// 


0x10 


7577 


'0', 


'P' , 


' {', 




'\n' 


NO, 


' A' , 


'S', 






7578 


'D' , 


'F' , 


'G' , 


'H' , 


'J', 


'K' , 


' L' , 


' . ' 


// 


0x20 


7579 


r n r 




NO, 




'Z', 


'X' , 


'C, 


'V , 






7580 


'B' , 


'N' , 


'M' , 


' <' , 


' >' , 


, 9, 


NO, 


' * ' 


// 


0x30 


7581 


NO, 




NO, 


NO, 


NO, 


NO, 


NO, 


NO, 






7582 


NO, 


NO, 


NO, 


NO, 


NO, 


NO, 


NO, 


'7', 


// 


0x40 


7583 


'8', 


'9', 




'4' , 


'5', 


' 6' , 


'+', 


'1', 






7584 


'2' , 


'3', 


'0', 


t f 


NO, 


NO, 


NO, 


NO, 


// 


0x50 


7585 


[0x9C] 


'\n 




II KP 


Enter 










7586 


[0xB5] 


'/' 




// KP_ 


Div 












7587 


[OxCB] 


KEY, 


_UP, 


[OxDO] 


KEY, 


,DN, 










7588 


[0xC9] 


KEY. 


.PGUP, 


[OxDl] 


KEY. 


.PGDN, 










7589 


[OxCB] 


KEY. 


-LF, 


[OxCD] 


KEY. 


.RT, 










7590 


[0x97] 


KEY. 


.HOME, 


[OxCF] 


KEY. 


.END, 










7591 


[0xD2] 


KEY. 


.INS, 


[0xD3] 


KEY. 


.DEL 










7592 


}; 




















7593 






















7594 






















7595 






















7596 






















7597 






















7598 






















7599 
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7600 static uchar ctlmap[256] = 

7601 ( 



7602 


NO, 


NO, 


NO, 


NO, 


NO, 


NO, 


NO, 


NO, 


7603 


NO, 


NO, 


NO, 


NO, 


NO, 


NO, 


NO, 


NO, 


7604 


C('Q'), 


C('W') , 


C('E'), 


C('R'), 


C('T'), 


C('Y'), 


, ecu'), 


. C('I' 


7605 


C('O'), 


C('P' ) , 


NO, 


NO, 


'\r'. 


NO, 


C('A'), 


■ CCS' 


7606 


C('D'), 


C('F'), 


C('G'), 


C('H'), 


CC J'), 


C('K'), 


, C('L'), 


■ NO, 


7607 


NO, 


NO, 


NO, 


CCW), 


C('Z'), 


C('X'), 


. C('C'), 


, ccv 


7608 


C('B'), 


C('N'), 


C('M'), 


NO, 


NO, 


CC/'), 


, NO, 


NO, 


7609 


[0x9C] 


' \r' , 


// KP_Enter 










7610 


[0xB5] 


CC/'), 


// KP_Div 










7611 


[0xC8] 


KEY_UP, 


[OxDO] 


KEY_DN, 










7612 


[0xC9] 


KEY_PGUP, 


[OxDl] 


KEY_PGDN, 










7613 


[OxCB] 


KEY_LF, 


[OxCD] 


KEY_RT, 










7614 


[0x97] 


KEYJOME, 


[OxCF] 


KEY_END, 










7615 


[0xD2] 


KEY_1NS, 


[OxD3] 


KEY_DEL 











7616 }; 

7617 

7618 

7619 

7620 

7621 

7622 

7623 

7624 

7625 

7626 

7627 

7628 

7629 

7630 

7631 

7632 

7633 

7634 

7635 

7636 

7637 

7638 

7639 

7640 

7641 

7642 

7643 

7644 

7645 

7646 

7647 

7648 

7649 
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7650 tinclude "types. h" 

7651 #include "x86.h" 

7652 tinclude "defs.h" 

7653 #include "kbd.h" 
7654 

7655 int 

7656 kbdgetc (void) 

7657 { 

7658 static uint shift; 

7659 static uchar *charcode[4] = { 

7660 norraalmap, shiftraap, ctlmap, ctlmap 

7661 ); 

7662 uint st, data, c; 

7663 

7664 St = inb(KBSTATP) ; 

7665 if ((St & KBS_DIB) == 0) 

7666 return -1; 

7667 data = inb (KBDATAP) ; 

7668 

7669 if (data == OxEO) { 

7670 shift 1= EOESC; 

7671 return 0; 

7672 } else if (data S 0x80) { 

7673 // Key released 

7674 data = (shift S EOESC ? data : data S 0x7F) ; 

7675 shift &= -(shiftcode [data] j EOESC); 

7676 return 0; 

7677 } else if (shift & EOESC) { 

7678 // Last character was an EO escape; or with 0x80 

7679 data |= 0x80; 

7680 shift &= -EOESC; 

7681 } 
7682 

7683 shift |= shiftcode [data] ; 

7684 shift ^= togglecode [data] ; 

7685 c = charcode[ shift S (CTL j SHIFT) ] [data] ; 

7686 if (shift S CAPSLOCK) { 

7687 ifCa' <= c SS c <= 'z') 

7688 c += 'A' - 'a'; 

7689 else ifCA' <= c SS c <= 'Z') 

7690 c += 'a' - 'A'; 

7691 } 

7692 return c; 

7693 } 
7694 

7695 void 

7696 kbdintr(void) 

7697 { 

7698 consoleintr (kbdgetc) ; 

7699 ) 
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7700 // Console input and output. 

7701 // Input is from the keyboard or serial port. 

7702 // Output is written to the screen and serial port. 
7703 

7704 #include "types. h" 

7705 tinclude "defs.h" 

7706 tinclude "param.h" 

7707 tinclude "traps. h" 

7708 tinclude "spinlock.h" 

7709 tinclude "fs.h" 

7710 #include "file.h" 

7711 #include "memlayout .h" 

7712 tinclude "mmu.h" 

7713 tinclude "proc.h" 

7714 tinclude "x86.h" 
7715 

7716 static void consputc (int) ; 

7717 

7718 static int panicked = 0; 

7719 

7720 static struct { 

7721 struct spinlock lock; 

7722 int locking; 

7723 } cons; 
7724 

7725 static void 

7726 printint(int xx, int base, int sign) 

7727 { 



7728 


static char digits [] ■■ 


7729 


char buf [16] ; 


7730 


int i; 


7731 


uint x; 


7732 




7733 


if (sign &S (sign = xx 


7734 


X = -xx; 


7735 


else 


7736 


X = xx; 


7737 




7738 


i = 0; 


7739 


do{ 


7740 


buf [i++] = digits [x 


7741 


}while ( (x /= base) != 


7742 




7743 


if (sign) 


7744 


buf[i++] = '-'; 


7745 




7746 


while (—1 >= 0) 


7747 


consputc (buf [i] ) ; 


7748 ; 


1 


7749 





< 0)) 



base] ; 
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7750 // Print to the console, only understands %d, 

7751 void 

7752 cprintf(char *fmt, ...) 

7753 { 



7754 int i, c, locking; 

7755 uint *argp; 

7756 char *s; 
7757 

7758 locking = cons. locking; 

7759 if(locking) 

7760 acquire (Scons . lock) ; 

7761 

7762 if (fmt == 0) 

7763 panic ("null fmt") ; 
7764 

7765 argp = (uint*) (void*) (Sfmt + 1); 

7766 ford = 0; (c = fmt[i] S Oxff) != 0; i++) { 

7767 if (c != '%' ) { 

7768 consputc (c); 

7769 continue; 

7770 } 

7771 c = fmt[++i] & Oxff; 

7772 if (c == 0) 

7773 break; 

7774 switch(c){ 

7775 case 'd' : 

7776 printint (*argp++, 10, 1); 

7777 break; 

7778 case 'x' : 

7779 case 'p' : 

7780 printint (*argp++, 16, 0); 

7781 break; 

7782 case 's' : 

7783 if((s = (char*) *argp++) == 0) 

7784 s = " (null) "; 

7785 for(; *s; s++) 

7786 consputc (*s) ; 

7787 break; 

7788 case '%' : 

7789 consputc ('%') ; 

7790 break; 

7791 default: 

7792 // Print unknown % sequence to draw attention. 

7793 consputc ('%') ; 

7794 consputc (c); 

7795 break; 

7796 } 

7797 } 
7798 
7799 
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7800 if(locking) 

7801 release (Scons .lock) ; 

7802 } 
7803 

7804 void 

7805 panic(char *s) 

7806 { 

7807 int 1; 

7808 uint pes [10]; 
7809 

7810 cliO; 

7811 cons. locking = 0; 

7812 cprintf ("cpu%d: panic: ", cpu->id) ; 

7813 cprintf (s); 

7814 cprintf ("\n") ; 

7815 getcallerpcs (&s, pes); 

7816 for(i=0; i<10; i++) 

7817 cprintf (" %p", pcs[i]); 

7818 panicked = 1; // freeze other CPU 

7819 for(;;) 

7820 ; 

7821 } 
7822 
7823 
7824 
7825 
7826 
7827 
7828 
7829 
7830 
7831 
7832 
7833 
7834 
7835 
7836 
7837 
7838 
7839 
7840 
7841 
7842 
7843 
7844 
7845 
7846 
7847 
7848 
7849 
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7850 tdefine BACKSPACE 0x100 

7851 tdefine CRTPORT 0x3d4 

7852 static ushort *crt = (ushort*)P2V(0xb8000) ; // CGA memory 
7853 

7854 static void 

7855 cgaputc(int c) 

7856 { 

7857 int pos; 
7858 

7859 // Cursor position: col + 80*row. 

7860 outb (CRTPORT, 14); 

7861 pos = inb(CRTPORT+l) « 8; 

7862 outb (CRTPORT, 15); 

7863 pos 1= inb (CRTPORT+1) ; 
7864 

7865 if (c == ' \n' ) 

7866 pos += 80 - pos%80; 

7867 else if(c == BACKSPACES 

7868 if (pos > 0) —pos; 

7869 ) else 

7870 crt[pos++] = (cSOxff) | 0x0700; // black on white 
7871 

7872 if((pos/80) >= 24) { // Scroll up. 

7873 memmove(crt, crt+80, sizeof (crt [0] ) *23*80) ; 

7874 pos -= 80; 

7875 memset (crt+pos, 0, sizeof (crt [0] )* (24*80 -pos)); 

7876 } 
7877 

7878 outb (CRTPORT, 14); 

7879 outb (CRTPORT+1, pos»8); 

7880 outb (CRTPORT, 15); 

7881 outb (CRTPORT+1, pos); 

7882 crt [pos] = ' ' I 0x0700; 

7883 ) 
7884 

7885 void 

7886 consputc(int c) 

7887 { 

7888 if (panicked) ( 

7889 cli(); 

7890 for(;;) 

7891 ; 

7892 } 
7893 

7894 if (c == BACKSPACE) ( 

7895 uartputc('\b') ; uartputcC '); uartputc (' \b' ) ; 

7896 } else 

7897 uartputc (c); 

7898 cgaputc(c); 

7899 ) 
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7900 #define 1NPUT_BUF 128 

7901 struct { 

7902 struct spinlock lock; 

7903 char buf [INPUT_BUF] ; 

7904 uint r; // Read index 

7905 uint w; // Write index 

7906 uint e; // Edit index 

7907 } input; 
7908 

7909 #define C(x) ((x)-'@') // Control-x 

7910 

7911 void 

7912 consoleintr (int (*getc) (void) ) 

7913 { 

7914 int c; 
7915 

7916 acquire (Sinput . lock) ; 

7917 while ( (c = getc() ) >= 0) { 



7918 switch (c){ 

7919 case C('P'): // Process listing. 
7 920 procdumpO; 

7921 break; 

7922 caseC('U'): //Kill line. 

7923 while (input .e != input. w S& 

7924 input.buf[ (input. e-1) % INPUT_BUF] != '\n'){ 

7925 input. e — ; 

7926 oonsputc (BACKSPACE) ; 

7927 } 

7928 break; 

7929 case C('H'): case '\x7f': // Backspace 

7930 if (input. e != input. w){ 
7 931 input. e — ; 

7932 consputc (BACKSPACE) ; 

7933 } 

7934 break; 

7935 default: 

7936 if(c != 0 SS input .e-input . r < INPUT_BUF) { 

7937 c = (c == '\r' ) ? '\n' : c; 

7938 input. buf [input. e++ % INPUT_BUF] = c; 

7939 consputc (c); 

7940 if(c == '\n' || c == C('D') || input. e == input. 

7941 input. w = input. e; 

7942 wakeup (Sinput. r) ; 

7943 } 

7944 } 

7945 break; 

7946 } 



7947 } 

7948 release (Sinput . lock) ; 

7949 } 
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7950 int 

7951 consoleread (struct inode *ip, char *dst, int n) 

7952 { 

7953 uint target; 

7954 int c; 
7955 

7956 iunlock(ip); 

7957 target = n; 

7958 acquire (Sinput . lock) ; 

7959 while(n > 0) { 



7960 while (input . r == input. w){ 

7961 if (proc->killed) { 

7962 release (Sinput. lock) ; 

7963 ilock(ip); 

7964 return -1; 

7965 } 

7966 sleep (Sinput .r, Sinput . lock) ; 

7967 } 

7968 c = input. buf [input. r++ % INPUT_BUF]; 

7969 if (c == CCD' ) ) { // EOF 

7970 if (n < target) ( 

7971 // Save for next time, to make sure 

7972 // caller gets a 0-byte result. 

7973 input. r — ; 

7974 } 

7975 break; 

7976 } 

7977 *dst++ = c; 

7978 ~n; 

7979 if(c == '\n') 

7980 break; 



7981 } 

7982 release (Sinput . lock) ; 

7983 ilock(ip); 
7984 

7985 return target - n; 

7986 ) 
7987 
7988 
7989 
7990 
7991 
7992 
7993 
7994 
7995 
7996 
7997 
7998 
7999 
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8000 int 

8001 consolewrite (struct inode *ip, char *buf, int n) 

8002 { 

8003 int i; 
8004 

8005 iunlock(ip) ; 

8006 acquire (Scons .lock) ; 

8007 for(i = 0; i < n; i++) 

8008 consputc(buf [i] & Oxff ) ; 

8009 release (Scons .lock) ; 

8010 ilock(ip); 
8011 

8012 return n; 

8013 } 
8014 

8015 void 

8016 consoleinit (void) 

8017 { 

8018 initlock (Scons . lock, "console"); 

8019 initlock(&input.lock, "input"); 
8020 

8021 devsw[CONSOLE] .write = consolewrite; 

8022 devsw [CONSOLE] .read = consoleread; 

8023 cons. locking = 1; 
8024 

8025 picenable(IRQ_KBD) ; 

8026 ioapicenable(IRQ_KBD, 0); 

8027 } 
8028 

8029 
8030 
8031 
8032 
8033 
8034 
8035 
8036 
8037 
8038 
8039 
8040 
8041 
8042 
8043 
8044 
8045 
8046 
8047 
8048 
8049 
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8050 // Intel 8253/8254/82C54 Programmable Interval Timer (PIT) . 

8051 // Only used on uniprocessors; 

8052 // SMP machines use the local APIC timer. 
8053 

8054 #include "types. h" 

8055 #include "defs.h" 

8056 #include "traps. h" 

8057 #include "x86.h" 
8058 

8059 #define I0_TIMER1 0x040 // 8253 Timer #1 

8060 

8061 // Frequency of all three count-down timers; 

8062 // (TIMER_FREQ/freq) is the appropriate count 

8063 // to generate a frequency of freq Hz. 
8064 

8065 #define TIMER_FREQ 1193182 

8066 #define TIMER_DIV(x) ( (TIMER_FREQ+ (x) /2) / (x) ) 

8067 

8068 tdefine TIMER_MODE (10_TIMER1 + 3) // timer mode port 

8069 tdefine TIMER_SELO 0x00 // select counter 0 

8070 tdefine TIMER_RATEGEN 0x04 // mode 2, rate generator 

8071 tdefine TIMER_16BIT 0x30 // r/w counter 16 bits, LSB first 
8072 

8073 void 

8074 timerinit(void) 

8075 { 

8076 // Interrupt 100 times/sec. 

8077 outb(TIMER_MODE, TIMER_SEL0 I TIMER_RATEGEN | TIMER_16BIT) ; 

8078 outb(IO_TIMERl, TIMER_DIV(100) % 256); 

8079 outb(IO_TIMERl, TIMER_DIV(100) / 256); 

8080 picenable (IRQ_TIMER) ; 

8081 ) 
8082 
8083 
8084 
8085 



8090 
8091 
8092 
8093 
8094 
8095 
8096 
8097 
8098 
8099 
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8100 


// Intel 8250 serial port (UART) . 


8150 


void 


8101 




8151 


uartputc (int c) 


8102 


tinclude "types. h" 


8152 


{ 


8103 


♦include "defs.h" 


8153 


int i; 


8104 


tinclude "param.h" 


8154 




8105 


tinclude "traps. h" 


8155 


if (!uart) 


8106 


tinclude "spinlock.h" 


8156 


return; 


8107 


tinclude "fs.h" 


8157 


for(i = 0; i < 128 &S ! (inb (COMl+5) 


8108 


tinclude "file.h" 


8158 


microdelay (10) ; 


8109 


tinclude "mmu.h" 


8159 


outb(COMl+0, c); 


8110 


#include "proc.h" 


8160 


) 


8111 


♦include "x86.h" 


8161 




8112 




8162 


static int 


8113 


♦define COMl Ox3f8 


8163 


uartgetc (void) 


8114 




8164 


{ 


8115 


static int uart; //is there a uart? 


8165 


if (!uart) 


8116 




8166 


return -1; 


8117 


void 


8167 


if (! (inb(C0Ml+5) & 0x01) ) 


8118 


uartinit (void) 


8168 


return -1; 


8119 


{ 


8169 


return inb(COMl+0) ; 


8120 


char *p; 


8170 


) 


8121 




8171 




8122 


// Turn off the FIFO 


8172 


void 


8123 


outb(C0Ml+2, 0); 


8173 


uartintr (void) 


8124 




8174 


{ 


8125 


// 9600 baud, 8 data bits, 1 stop bit, parity off. 


8175 


consoleintr (uartgetc) ; 


8126 


outb(C0Ml+3, 0x80); // Unlock divisor 


8176 


} 


8127 


outb(COMl+0, 115200/9600); 


8177 




8128 


outb(COMl+l, 0); 


8178 




8129 


outb(C0Ml+3, 0x03); // Lock divisor, 8 data bits. 


8179 




8130 


outb(C0Ml+4, 0); 


8180 




8131 


outb(COMl+l, 0x01); // Enable receive interrupts. 


8181 




8132 




8182 




8133 


// If status is OxFF, no serial port. 


8183 




8134 


if (inb(C0Ml+5) == OxFF) 


8184 




8135 


return; 


8185 




8136 


uart = 1; 


8186 




8137 




8187 




8138 


// Acknowledge pre-existing interrupt conditions; 


8188 




8139 


// enable interrupts. 


8189 




8140 


inb(C0Ml+2) ; 


8190 




8141 


inb(COMl+0) ; 


8191 




8142 


picenable (IRQ_C0M1) ; 


8192 




8143 


ioapicenable(IRQ_COMl, 0); 


8193 




8144 




8194 




8145 


// Announce that we're here. 


8195 




8146 


for(p="xv6. . .\n"; *p; p++) 


8196 




8147 

8148 


uartputc (*p) ; 

} 


8197 
8198 




8149 




8199 
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8200 
8201 
8202 
8203 
8204 
8205 
8206 
8207 
8208 
8209 
8210 
8211 
8212 
8213 
8214 
8215 
8216 
8217 
8218 
8219 
8220 
8221 
8222 
8223 
8224 
8225 
8226 
8227 
8228 
8229 
8230 
8231 
8232 
8233 
8234 
8235 
8236 
8237 
8238 
8239 
8240 
8241 
8242 
8243 
8244 
8245 
8246 
8247 
8248 
8249 



# Initial process execs /init. 

tinclude "syscall.h" 
tinclude "traps. h" 



# exec (init, argv) 
.globl start 
start : 

pushl $argv 

pushl $init 

pushl $0 // where caller pc would be 
movl $SYS_exec, %eax 
int $T_SYSCALL 

# for(;;) exit(); 
exit : 

movl $SYS_exit, %eax 
int $T_SYSCALL 
jmp exit 

# char initi] = "/init\0"; 
init : 

.string "/init\0" 



# char *argv[] 
.p2align 2 
argv: 

.long init 

.long 0 



init, 0 }; 



8250 
8251 
8252 
8253 
8254 
8255 
8256 
8257 
8258 
8259 
8260 
8261 
8262 
8263 
8264 
8265 
8266 
8267 
8268 
8269 
8270 
8271 
8272 
8273 
8274 
8275 
8276 
8277 
8278 
8279 
8280 
8281 
8282 
8283 
8284 
8285 
8286 
8287 
8288 
8289 
8290 
8291 
8292 
8293 
8294 
8295 
8296 
8297 
8298 
8299 



♦include 
♦include 



'syscall.h" 
'traps .h" 



♦define SYSCALL (name) \ 
.globl name; \ 
name : \ 

movl $SYS_ ## name, %eax; \ 

int $T_SYSCALL; \ 

ret 



SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 
SYSCALL 



(fork) 

(exit) 

(wait) 

(pipe) 

(read) 

(write) 

(close) 

(kill) 

(exec) 

(open) 

(mknod) 

(unlink) 

(fstat) 

(link) 

(mkdir) 

(chdir) 

(dup) 

(getpid) 

(sbrk) 

(sleep) 

(uptime) 
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8300 // init: The initial user-level program 

8301 

8302 tinclude "types. h" 

8303 tinclude "stat.h" 

8304 tinclude "user.h" 

8305 tinclude "fcntl.h" 
8306 

8307 char *argv[] = { "sh", 0 }; 
8308 

8309 int 

8310 main (void) 

8311 { 

8312 int pid, wpid; 

8313 

8314 if (open ("console", 0_RDWR) < 0) { 

8315 mknod( "console", 1, 1); 

8316 open("console", 0_RDWR) ; 

8317 ) 

8318 dup(O) ; // stdout 

8319 dup(O); // stderr 
8320 

8321 for(;;){ 

8322 printf(l, "init: starting sh\n") ; 

8323 pid = forkO ; 

8324 if (pid < 0) { 

8325 printf(l, "init: fork failed\n"); 

8326 exitO; 

8327 } 

8328 if (pid == 0) { 

8329 exec("sh", argv) ; 

8330 printf(l, "init: exec sh failed\n"); 

8331 exitO; 

8332 ) 

8333 while ( (wpid=wait 0 ) >= 0 &S wpid != pid) 

8334 printf(l, "zombie ! \n" ) ; 

8335 } 

8336 } 
8337 
8338 
8339 
8340 
8341 
8342 
8343 
8344 
8345 
8346 
8347 
8348 
8349 



8350 // Shell. 
8351 

8352 #include "types. h" 

8353 tinclude "user.h" 

8354 tinclude "fcntl.h" 
8355 

8356 // Parsed command representation 

8357 tdefine EXEC 1 

8358 tdefine REDIR 2 

8359 tdefine PIPE 3 

8360 tdefine LIST 4 

8361 tdefine BACK 5 
8362 

8363 tdefine MAXARGS 10 
8364 

8365 struct cmd { 

8366 int type; 

8367 }; 
8368 

8369 struct execcmd { 

8370 int type; 

8371 char *argv [MAXARGS] ; 

8372 char *eargv [MAXARGS ] ; 

8373 }; 
8374 

8375 struct redircmd { 

8376 int type; 

8377 struct cmd *cmd; 

8378 char *file; 

8379 char *efile; 

8380 int mode; 

8381 int fd; 

8382 }; 
8383 

8384 struct pipecmd { 

8385 int type; 

8386 struct cmd *left; 

8387 struct cmd *right; 

8388 ); 
8389 

8390 struct listcmd { 

8391 int type; 

8392 struct cmd *left; 

8393 struct cmd *right; 

8394 }; 
8395 

8396 struct backcmd { 

8397 int type; 

8398 struct cmd *cmd; 

8399 ); 
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8400 int forkl (void) ; // Fork but panics on failure. 

8401 void panic (char*) ; 

8402 struct cmd *parsecmd (char*) ; 
8403 

8404 // Execute cmd. Never returns. 

8405 void 

8406 runcmd(struct cmd *cmd) 

8407 { 

8408 int p[2]; 

8409 struct backcmd *bcmd; 

8410 struct execcmd *ecmd; 

8411 struct listcmd *lcmd; 

8412 struct pipecmd *pcmd; 

8413 struct redircmd *rcmd; 
8414 

8415 if (cmd == 0) 

8416 exitO; 
8417 

8418 switch (cmd- >type) { 

8419 default: 

8420 panic ("runcmd"); 
8421 

8422 case EXEC: 

8423 ecmd = (struct execcmd*) cmd; 

8424 if (ecmd->argv[0] == 0) 

8425 exitO; 

8426 exec (ecmd->argv [0] , ecmd->argv) ; 

8427 printf(2, "exec %s failed\n", ecrad->argv [0] ) ; 

8428 break; 

8429 

8430 case REDIR: 

8431 rcmd = (struct redircmd*) cmd; 

8432 close (rcmd->fd) ; 

8433 if (open (rcmd->f lie, rcmd->mode) < 0) { 

8434 printf(2, "open %s failed\n", rcmd->f ile) ; 

8435 exitO; 

8436 ) 

8437 runcmd (rcmd->cmd) ; 

8438 break; 
8439 

8440 case LIST: 

8441 Icmd = (struct listcmd*) cmd; 

8442 if (forkl 0 == 0) 

8443 runcmd (lcmd->left) ; 

8444 waitO; 

8445 runcmd (lcmd->right) ; 

8446 break; 
8447 

8448 
8449 
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8450 case PIPE: 

8451 pcmd = (struct pipecmd*) cmd; 

8452 if (pipe (p) < 0) 

8453 panic ("pipe") ; 

8454 if (forkl 0 == 0) { 

8455 close (1); 

8456 dup(p[l]); 

8457 close (p[0]); 

8458 close (p[l]); 

8459 runcmd (pcmd->left) ; 

8460 ) 

8461 if (forklO == 0) { 

8462 close (0); 

8463 dup(p[0]); 

8464 close(p[0]); 

8465 close (p[l]); 

8466 runcmd (pcmd->right) ; 

8467 } 

8468 close(p[0]); 

8469 close (p[l]); 

8470 waitO; 

8471 waitO; 

8472 break; 
8473 

8474 case BACK: 

8475 bcmd = (struct backcmd*) cmd; 

8476 if (forkl 0 == 0) 

8477 runcmd (bcmd->cmd) ; 

8478 break; 

8479 ) 

8480 exitO; 

8481 ) 
8482 

8483 int 

8484 getcmd(char *buf, int nbuf) 

8485 { 

8486 printf (2, "$ ") ; 

8487 memset(buf, 0, nbuf); 

8488 gets(buf, nbuf); 

8489 if(buf[0] == 0) // EOF 

8490 return -1; 

8491 return 0; 

8492 } 
8493 
8494 
8495 
8496 
8497 
8498 
8499 
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8500 int 

8501 main (void) 

8502 { 

8503 static char buf[100]; 

8504 int fd; 
8505 

8506 // Assumes three file descriptors open. 

8507 while ( (fd = open ("console", 0_RDWR) ) >= 0) { 



8508 if (fd >= 3) { 

8509 close (fd); 

8510 break; 

8511 } 



8512 } 
8513 

8514 // Read and run input commands. 

8515 while (getcmd(buf, sizeof(buf)) >= 0) { 



8516 if(buf[0] == 'c' SS buf[l] == 'd' && buf[2] == ' '){ 

8517 // Clumsy but will have to do for now. 

8518 // Chdir has no effect on the parent if run in the child 

8519 buf [strlen(buf)-ll = 0; // chop \n 

8520 if (chdir (buf +3) < 0) 

8521 printf(2, "cannot cd %s\n", buf+3) ; 

8522 continue; 

8523 } 

8524 if(forkl() == 0) 

8525 runcmd(parsecmd(buf) ) ; 

8526 waitO; 



8527 } 

8528 exitO; 

8529 } 

8530 

8531 void 

8532 panic (char *s) 

8533 ( 

8534 printf(2, "%s\n", s) ; 

8535 exitO; 

8536 } 
8537 

8538 int 

8539 forkl(void) 

8540 { 

8541 int pid; 
8542 

8543 pid = forkO; 

8544 if (pid == -1) 

8545 panic ("fork") ; 
854 6 return pid; 
8547 } 

8548 
8549 
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8550 // Constructors 
8551 

8552 struct cmd* 

8553 execcmd(void) 

8554 { 

8555 struct execcmd *cmd; 
8556 

8557 cmd = malloc (sizeof (*cmd) ) ; 

8558 memset (cmd, 0, sizeof (*cmd) ) ; 

8559 cmd->type = EXEC; 

8560 return (struct cmd*) cmd; 

8561 } 
8562 

8563 struct cmd* 

8564 redircmd (struct cmd *subcrad, char *file, char *efile, int mode, int fd) 

8565 { 

8566 struct redircmd *cmd; 

8567 

8568 cmd = malloc (sizeof (*cmd) ) ; 

8569 memset (cmd, 0, sizeof (*cmd) ) ; 

8570 cmd->type = REDIR; 

8571 cmd->cmd = subcmd; 

8572 cmd->file = file; 

8573 cmd->efile = efile; 

8574 cmd->raode = mode; 

8575 cmd->fd = fd; 

8576 return (struct cmd*) cmd; 

8577 } 
8578 

8579 struct cmd* 

8580 pipecmd( struct cmd *left, struct cmd *right) 

8581 ( 

8582 struct pipecmd *cmd; 
8583 

8584 cmd = malloc (sizeof (*cmd) ) ; 

8585 memset (cmd, 0, sizeof (*cmd) ) ; 

8586 cmd->type = PIPE; 

8587 cmd->left = left; 

8588 cmd->right = right; 

8589 return (struct cmd*) cmd; 

8590 } 
8591 
8592 
8593 
8594 
8595 
8596 
8597 
8598 
8599 
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8600 struct cmd* 

8501 listcmd (struct cmd *left, struct cmd *right) 

8602 { 

8603 struct listcmd *cmd; 
8604 

8605 cmd = malice (sizeof (*cmd) ) ; 

8606 memset(cmd, 0, sizeof (*cmd) ) ; 

8607 cmd->type = LIST; 

8608 cmd->left = left; 

8609 cmd->right = right; 

8610 return (struct cmd*) cmd; 

8611 } 
8612 

8613 struct cmd* 

8614 backcmd (struct cmd *subcmd) 

8615 { 

8616 struct backcmd *cmd; 

8617 

8618 cmd = malloc (sizeof (*cmd) ) ; 

8619 memseticmd, 0, sizeof (*cmd) ) ; 

8620 cmd->tYpe = BACK; 

8621 cmd->cmd = subcmd; 

8622 return (struct cmd*) cmd; 

8623 } 
8624 
8625 
8626 
8627 
8628 
8629 
8630 
8631 
8632 
8633 
8634 
8635 
8636 
8637 
8638 
8639 
8640 
8641 
8642 
8643 
8644 
8645 
8646 
8647 
8648 
8649 
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8650 // Parsing 
8651 

8652 char whitespace[] = " \t\r\n\v"; 

8653 char symbols [] = "<!>&;()"; 
8654 

8655 int 

8656 gettoken (char **ps, char *es, char **q, char **eq) 

8657 { 

8658 char *s; 

8659 int ret; 

8660 

8661 s = *ps; 

8662 while (s < es S& strchr (whitespace, *s) ) 

8663 S++; 

8664 if(q) 

8665 *q = s; 

8666 ret = *s; 

8667 switch(*s){ 

8668 case 0: 

8669 break; 

8670 case ' | ' : 

8671 case ' (' : 

8672 case ' ) ' : 

8673 case ' ; ' : 

8674 case '&' : 

8675 case '<' : 

8676 S++; 

8677 break; 

8678 case '>' : 

8679 S++; 

8680 if (*s == '>' ) { 

8681 ret = '+'; 

8682 S++; 

8683 } 

8684 break; 

8685 default: 

8686 ret = 'a'; 

8687 while (s < es S& ! strchr (whitespace, *s) &S ! strchr (symbols, *s)) 

8688 S++; 

8689 break; 

8690 } 

8691 if(eq) 

8692 *eq = s; 
8693 

8694 while (s < es SS strchr (whitespace, *s) ) 

8695 S++; 

8696 *ps = s; 

8697 return ret; 

8698 ) 
8699 
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8700 int 

8701 peek (char **ps, char *es, char *toks) 

8702 { 

8703 char *s; 
8704 

8705 s = *ps; 

8706 while (s < es && strchr (whitespace, *s)) 

8707 S++; 

8708 *ps = s; 

8709 return *s &S strchr(toks, *s); 

8710 } 
8711 

8712 struct cmd *parseline (char**, char*); 

8713 struct cmd *parsepipe (char**, char*); 

8714 struct cmd *parseexec (char**, char*); 

8715 struct cmd *nulterminate (struct cmd*); 
8716 

8717 struct cmd* 

8718 parsecmd(char *s) 

8719 { 

8720 char *es; 

8721 struct cmd *cmd; 
8722 

8723 es = s + strlen(s); 

8724 cmd = parseline (Ss, es); 

8725 peek(ss, es, ""); 

8726 if (s != es) { 

8727 printf(2, "leftovers: %s\n", s); 

8728 panic ("syntax") ; 

8729 } 

8730 nulterminate (cmd) ; 

8731 return cmd; 

8732 } 
8733 

8734 struct cmd* 

8735 parseline (char **ps, char *es) 

8736 { 

8737 struct cmd *cmd; 

8738 

8739 cmd = parsepipe (ps, es); 

8740 while (peek (ps, es, "&")){ 

8741 gettoken(ps, es, 0, 0); 

8742 cmd = backcmd (cmd) ; 

8743 } 

8744 if (peek(ps, es, ";") ) { 

8745 gettoken(ps, es, 0, 0); 

8746 cmd = listcmd(cmd, parseline (ps, es)); 

8747 } 

8748 return cmd; 

8749 } 



8750 struct cmd* 

8751 parsepipe (char **ps, char *es) 

8752 { 

8753 struct cmd *cmd; 
8754 

8755 cmd = parseexec (ps, es) ; 

8756 if (peek (ps, es, "!")){ 

8757 gettoken(ps, es, 0, 0); 

8758 cmd = pipecmd(cmd, parsepipe (ps, es) ) ; 

8759 } 

8760 return cmd; 

8761 ) 
8762 

8763 struct cmd* 

8764 parseredirs (struct cmd *cmd, char **ps, char *es) 

8765 { 

8766 int tok; 

8767 char *q, *eq; 
8768 

8769 while (peek (ps, es, "<>")){ 

8770 tok = gettoken(ps, es, 0, 0); 

8771 if (gettoken (ps, es, Sq, Seq) != 'a') 

8772 panic ("missing file for redirection"); 

8773 switch (tok) { 

8774 case '<' : 

8775 cmd = redircmd(cmd, q, eq, 0_RDONLY, 0); 

8776 break; 

8777 case '>' : 

8778 cmd = redircmd(cmd, q, eq, 0_WRONLY | 0_CREATE, 1); 

8779 break; 

8780 case '+' : // » 

8781 cmd = redircmd(cmd, q, eq, 0_WRONLY | 0_CREATE , 1) ; 

8782 break; 

8783 } 

8784 } 

8785 return cmd; 

8786 ) 
8787 
8788 
8789 
8790 
8791 
8792 
8793 
8794 
8795 
8796 
8797 
8798 
8799 
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8800 struct cmd* 

8801 parseblock (char **ps, char *es) 

8802 { 

8803 struct cmd *cmd; 
8804 

8805 if(!peek:(ps, es, "(")) 

8806 panic ("parseblock") ; 

8807 gettoken(ps, es, 0, 0); 

8808 cmd = parseline (ps, es); 

8809 if(!peek(ps, es, ")")) 

8810 panic ( "syntax - missing )"); 

8811 gettoken(ps, es, 0, 0); 

8812 cmd = parseredirs (cmd, ps, es); 

8813 return cmd; 

8814 } 
8815 

8816 struct cmd* 

8817 parseexec (char **ps, char *es) 

8818 { 

8819 char *q, *eq; 

8820 int tok, argc; 

8821 struct execcmd *cmd; 

8822 struct cmd *ret; 
8823 

8824 if (peek (ps, es, "(")) 

8825 return parseblock (ps, es); 
8826 

8827 ret = execcmdO; 

8828 cmd = (struct execcmd*) ret; 

8829 

8830 argc = 0; 

8831 ret = parseredirs (ret, ps, es) ; 

8832 while (!peek(ps, es, "!)&;")){ 

8833 if ( (tok=gettoken (ps, es, &q, Seq) ) == 0) 

8834 break; 

8835 if(tok != 'a') 

8836 panic ( "syntax" ) ; 

8837 cmd->argv [argc] = q; 

8838 cmd->eargv[argc] = eq; 

8839 argc++; 

8840 if (argc >= MAXARGS) 

8841 panic ("too many args"); 

8842 ret = parseredirs (ret, ps, es); 

8843 } 

8844 cmd->argv[argc] = 0; 

8845 cmd->eargv[argc] = 0; 

8846 return ret; 

8847 } 
8848 
8849 



8850 // NUL-terminate all the counted strings. 

8851 struct cmd* 

8852 nulterminate (struct cmd *cmd) 

8853 { 

8854 int i; 

8855 struct backcmd *bcmd; 

8856 struct execcmd *ecmd; 

8857 struct listcmd *lcmd; 

8858 struct pipecmd *pcmd; 

8859 struct redircmd *rcmd; 
8860 

8861 if (cmd == 0) 

8862 return 0; 
8863 

8864 switch( cmd->type ) { 

8865 case EXEC: 

8866 ecmd = (struct execcmd*) cmd; 

8867 for(i=0; ecmd->argv [i] ; i++) 

8868 *ecmd->eargv[i] = 0; 

8869 break; 
8870 

8871 case REDIR: 

8872 rcmd = (struct redircmd*) cmd; 

8873 nulterminate (rcmd->cmd) ; 

8874 *rcmd->efile = 0; 

8875 break; 
8876 

8877 case PIPE: 

8878 pcmd = (struct pipecmd*) cmd; 

8879 nulterminate (pcmd->left) ; 

8880 nulterminate (pcmd->right) ; 

8881 break; 
8882 

8883 case LIST: 

8884 Icmd = (struct listcmd*) cmd; 

8885 nulterminate (lcmd->left) ; 

8886 nulterminate (lcmd->right) ; 

8887 break; 
8888 

8889 case BACK: 

8890 bcmd = (struct backcmd*) cmd; 

8891 nulterminate (bcmd->cmd) ; 

8892 break; 

8893 } 

8894 return cmd; 

8895 } 
8896 
8897 
8898 
8899 
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8900 


#include 


"asm.h" 




8901 


#include 


"memlayout .h" 




8902 


tinclude 


"mmu.h" 




8903 








8904 


# Start the first CPU: 


switch to 32-bit protected mode, jump into C. 


8905 


# The BIOS loads this 


code from the first sector of the hard disk into 


8906 


# memory at physical address 0x7c00 and starts executing in real mode 


8907 


# with % 


:s=0 %ip=7c00. 




8908 
8909 


.codel6 




# Assemble for 16-bit mode 


8910 


.globl start 




8911 


start : 






8912 


cli 




# BIOS enabled interrupts; disable 


8913 








8914 


# Zero 


data segment 


registers DS, ES, and SS. 


8915 


xorw 


%ax, %ax 


# Set %ax to zero 


8916 


movw 


lax, %ds 


# -> Data Segment 


8917 


movw 


%ax, %es 


# -> Extra Segment 


8918 


movw 


%ax, %ss 


# -> Stack Segment 


8919 








8920 


# Physical address line A20 is tied to zero so that the first PCs 


8921 


# with 


2 MB would run software that assumed 1 MB. Undo that. 


8922 


seta20.1 






8923 


inb 


$0x64, %al 


# Wait for not busy 


8924 


testb 


$0x2, %al 




8925 


jnz 


seta20.1 




8926 








8927 


movb 


$Oxdl,%al 


# Oxdl -> port 0x64 


8928 


outb 


%al,$0x64 




8929 








8930 


seta20 . 2 






8931 


inb 


$0x64, %al 


# Wait for not busy 


8932 


testb 


$0x2, %al 




8933 


jnz 


seta20.2 




8934 








8935 


movb 


$Oxdf,%al 


# Oxdf -> port 0x60 


8936 


outb 


%al, $0x60 




8937 








8938 


# Switch from real to protected mode. Use a bootstrap GDT that make 


8939 


# virtual addresses map directly to physical addresses so that the 


8940 


# effective memory map doesn't change during the transition. 


8941 


Igdt 


gdtdesc 




8942 


movl 


%crO, %eax 




8943 


orl 


$CRO_PE, %eax 


8944 
8945 


movl 


%eax, %crO 




8946 
8947 
8948 








8949 
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8950 


# Complete transition to 32-bit protected mode by using long jmp 


8951 


# to reload %cs and %eip. The segment descriptors are set up with 


8952 


# translation, so that the mapping is still the identity mapping. 


8953 


1 jmp 


$ (SEG_KC0DE«3) , $start32 


8954 






8955 


. code32 


# Tell assembler to generate 32-bit code now. 


8956 


start32 




8957 


# Set 


up the protected-mode data segment registers 


8958 


movw 


$ (SEG_KDATA«3) , %ax # Our data segment selector 


8959 


movw 


%ax, %ds # -> DS: Data Segment 


8960 


movw 


%ax, %es # -> ES: Extra Segment 


8961 


movw 


%ax, %ss # -> SS: Stack Segment 


8962 


movw 


$0, %ax # Zero segments not ready for use 


8963 


movw 


%ax, %fs # -> FS 


8964 


movw 


%ax, %gs # -> GS 


8965 






8966 


# Set 


up the stack pointer and call into C. 


8967 


movl 


$start, %esp 


8968 


call 


bootmain 


8969 






8970 


# If bootmain returns (it shouldn't), trigger a Bochs 


8971 


# breakpoint if running under Bochs, then loop. 


8972 


movw 


$0x8a00, %ax # OxSaOO -> port OxSaOO 


8973 


movw 


%ax, %dx 


8974 


outw 


%ax, %dx 


8975 


movw 


$0x8ae0, %ax # OxSaeO -> port OxSaOO 


8976 


outw 


%ax, %dx 


8977 


spin: 




8978 

8979 


jmp 


spin 


8980 


# Bootstrap GDT 


8981 


.p2align 2 # force 4 byte alignment 


8982 


gdt: 




8983 


SEG_NULLASM # null seg 


8984 


SEG_ASM(STA_X|STA_R, 0x0, Oxffffffff) # code seg 


8985 
8986 


SEG_ASM(STA_W, 0x0, Oxffffffff) # data seg 


8987 


gdtdesc 




8988 


.word 


(gdtdesc - gdt - 1) # sizeof(gdt) - 1 


8989 


. long 


gdt # address gdt 


8990 






8991 






8992 






8993 






8994 






8995 






8996 
8997 







8998 
8999 
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9000 // Boot loader. 

9001 // 

9002 // Part of the boot sector, along with bootasm.S, which calls bootmai 

9003 // bootasm.S has put the processor into protected 32-bit mode. 

9004 // bootmainO loads an ELF kernel image from the disk starting at 

9005 // sector 1 and then jumps to the kernel entry routine. 
9006 

9007 tinclude "types. h" 

9008 tinclude "elf.h" 

9009 tinclude "x86.h" 

9010 tinclude "memlayout .h" 

9011 

9012 tdefine SECTSIZE 512 

9013 

9014 void readseg (uchar*, uint, uint) ; 

9015 

9016 void 

9017 bootmain (void) 

9018 ( 

9019 struct elfhdr *elf; 

9020 struct proghdr *ph, *eph; 

9021 void (*entry) (void) ; 

9022 uchar* pa; 
9023 

9024 elf = (struct elfhdr*) 0x10000; // scratch space 
9025 

9026 // Read 1st page off disk 

9027 readseg ( (uchar*) elf, 4096, 0); 
9028 

9029 // Is this an ELF executable? 

9030 if (elf->magic != ELF_MAGIC) 

9031 return; // let bootasm.S handle error 

9032 

9033 // Load each program segment (ignores ph flags) . 

9034 ph = (struct proghdr*) ( (uchar*) elf + elf->phof f ) ; 

9035 eph = ph + elf->phnum; 

9036 for (; ph < eph; ph++) { 

9037 pa = (uchar*)ph->paddr; 

9038 readseg (pa, ph->filesz, ph->of f ) ; 

9039 if (ph->memsz > ph->filesz) 

9040 stosb(pa + ph->filesz, 0, ph->memsz - ph->filesz) ; 

9041 } 
9042 

9043 // Call the entry point from the ELF header. 

9044 // Does not return! 

9045 entry = (void(*) (void) ) (elf->entry) ; 

9046 entry 0; 

9047 } 
9048 
9049 
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9050 void 

9051 waitdisk(void) 

9052 { 

9053 // Wait for disk ready. 

9054 while( (inb(0xlF7) S OxCO) != 0x40) 

9055 ; 

9056 } 
9057 

9058 // Read a single sector at offset into dst. 

9059 void 

9060 readsect (void *dst, uint offset) 

9061 { 

9062 // Issue command. 

9063 waitdiskO; 

9064 outb(0xlF2, 1); // count = 1 

9065 outb(0xlF3, offset); 

9066 outb(0xlF4, offset » 8); 

9067 outb(0xlF5, offset » 16); 

9068 outb(0xlF6, (offset » 24) | OxEO) ; 

9069 outb(0xlF7, 0x20); // cmd 0x20 - read sectors 
9070 

9071 // Read data. 

9072 waitdiskO; 

9073 insl(0xlF0, dst, SECTSIZE/4); 

9074 } 
9075 

9076 // Read 'count' bytes at 'offset' from kernel into physical address 'pa' 

9077 // Might copy more than asked. 

9078 void 

9079 readseg (uchar* pa, uint count, uint offset) 

9080 { 

9081 uchar* epa; 
9082 

9083 epa = pa + count; 

9084 

9085 // Round down to sector boundary. 

9086 pa -= offset % SECTSIZE; 
9087 

9088 // Translate from bytes to sectors; kernel starts at sector 1. 

9089 offset = (offset / SECTSIZE) + 1; 
9090 

9091 // If this is too slow, we could read lots of sectors at a time. 

9092 // We'd write more to memory than asked, but it doesn't matter — 

9093 // we load in increasing order. 

9094 for(; pa < epa; pa += SECTSIZE, offset++) 

9095 readsect (pa, offset); 

9096 ) 
9097 
9098 
9099 
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